finite-automata-toolkit

Collection of GUI tools, built with Streamlit, to create and interact with finite automata.

---

Installation

Prerequisites

• Python 3.12.9 or newer
• Miniconda or Anaconda (optional)
• Graphviz (required for visualization)

Setup Instructions

1. Clone the repository

   git clone https://github.com/emberfox205/finite-automata-toolkit.git
   cd finite-automata-toolkit

2. Install Graphviz (system dependency)

   On Windows:

   # Download and install from https://graphviz.org/download/
   # Make sure to add Graphviz to your PATH during installation

   On macOS:

   brew install graphviz

   On Ubuntu/Debian:

   sudo apt update
   sudo apt install graphviz

3. Set up environment (choose one option):

   Option A: Using Python's venv

   python -m venv venv
   # On Windows
   venv\Scripts\activate
   # On macOS/Linux
   source venv/bin/activate

   Option B: Using Conda (optional)

   conda create -n finite-automata python=3.12.9
   conda activate finite-automata

4. Install required dependencies

   pip install -r requirements.txt

5. Run the application

   streamlit run main.py