Runnable examples

Clone the repository to run real Hedron servers. The simulated UI patterns in these docs are a browser simulation—not a live Hedron process.

Each recipe page below also has a Try it (simulated) Demo/Code tab so you can click through the interaction before starting uvicorn.

git clone https://github.com/eddiethedean/hedron.git
cd hedron
uv sync

Recipes (prefer these)

Example	Framework	Simulated demo	Run
reference-app	FastAPI	Try it	uv run uvicorn app:app --app-dir examples/reference-app --reload
notes-sqlalchemy	FastAPI	Try it	uv run uvicorn app:app --app-dir examples/notes-sqlalchemy --reload
session-auth	FastAPI	Try it	uv run uvicorn app:app --app-dir examples/session-auth --reload
file-upload	FastAPI	Try it	uv run uvicorn app:app --app-dir examples/file-upload --reload
jobs-poll	FastAPI	Try it	uv run uvicorn app:app --app-dir examples/jobs-poll --reload
live-interaction	FastAPI	Live poll	uv run uvicorn app:app --app-dir examples/live-interaction --reload
flask-reference	Flask	—	See example README
django-reference	Django	—	See example README
hdj-progressive	HDJ	—	Prints HTML to stdout (not a web server)

Phase evidence (0.15–0.18)

Capability-phase exit scenarios — not polished product demos. See Phase evidence.

Example	Run
model-demo-0.18	uv run uvicorn app:app --app-dir examples/model-demo-0.18 --reload
dashboard-0.17	uv run uvicorn app:app --app-dir examples/dashboard-0.17 --reload
data-app-0.16	uv run uvicorn app:app --app-dir examples/data-app-0.16 --reload
data-app-0.15	uv run uvicorn app:app --app-dir examples/data-app-0.15 --reload

Evaluator shortcuts: CRUD tutorial · Try with Codespaces / Dev Container · Single-file apps.

Quickstarts without cloning: Single-file apps · FastAPI · Flask · Django.