Runbook — local dev

Start the stack

# from repo root
docker compose up -d                 # postgres + minio
cd api && source .venv/bin/activate
alembic upgrade head
uvicorn app.main:app --reload --port 8000

# in a second terminal
cd web && npm run dev                # binds to :3010

Reseed the demo

# DROP and rebuild the dev DB, then reseed
psql -h localhost -U postgres -d teloma -c "DROP SCHEMA public CASCADE; CREATE SCHEMA public;"
cd api && alembic upgrade head && python -m app.seed

Research AI (optional)

Calanthe is provisioned as an agent on the platform's managed AI environment. If the agent endpoint is unreachable, the Research Assistant returns its deterministic fallback.