Discrete Structures Project

Interactive Streamlit app (using uv) to explore simple graphs, trees, spanning trees/MSTs, and planarity/Euler/Hamiltonian concepts.

• Co-made with @Samwin88

Prerequisites

• Python 3.14.x installed
• uv package manager installed and on your PATH

Check:

python --version
uv --version

# Create / sync the virtual environment from pyproject.toml

uv sync

This will create a .venv/ folder and install streamlit, networkx, matplotlib, etc.

Running the app locally

Activate the environment and run Streamlit:

# Option 1: use uv to run directly

uv run streamlit run main.py

# Option 2: activate the venv, then run

source .venv/bin/activate        \# on macOS / Linux

# .venv\Scripts\activate         \# on Windows PowerShell

streamlit run main.py

The app should automatically launch in a new browser window. If not, then open the URL shown in the terminal (usually http://localhost:8501) in your browser.

Project structure

├── .venv/ # Local virtual environment created by uv (not committed - appears locally when you initialize the environment)
├── .python-version # Python version hint for tools like uv/pyenv
├── main.py # Streamlit app entry point (all pages live here)
├── pyproject.toml # Project metadata and dependencies managed by uv
├── uv.lock # Resolved dependency lockfile (generated by uv)
└── README.md # This file: setup and usage instructions