Quickstart

This guide mirrors the repo README.md and adds a minimal “full stack” path using Docker Compose.

Web (Next.js)

cd apps/web
npm install
npm run dev

API (FastAPI)

cd apps/api
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# Required for DB-backed endpoints (datasets/models/scenarios/runs)
export DATABASE_URL='postgresql+psycopg://ammm:ammm@localhost:5433/ammm'

# Storage root for uploads/models/outputs.
# IMPORTANT: if you run uvicorn from apps/api, use `storage` so it resolves to
# repo-root `ammm-app/storage`.
export STORAGE_ROOT='storage'

uvicorn main:app --reload --host 127.0.0.1 --port 8010

Local infra (recommended)

Bring up Postgres + Redis + the durable v2 API + worker (built from the sibling ../ammm repo):

# from repo root
docker compose up -d
docker compose ps
docker compose logs -f

Notes:

• Compose uses POSTGRES_PORT (default 5432). If you need 5433, export it before up.
• Web uses NEXT_PUBLIC_API_BASE_URL (see .env.example) to point at the backend.