Local Development

docker compose up --build

# View logs
docker compose logs backend -f
docker compose logs frontend -f

# Rebuild one service
docker compose up -d --build backend

# Reset everything
docker compose down -v && docker compose up --build

# Open PostgreSQL shell
docker compose exec db psql -U nil nil_benchmark

# Open MinIO console
open http://localhost:9001   # admin: minioadmin / minioadmin

# FastAPI auto-docs
open http://localhost:8000/docs

cd backend
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
export DATABASE_URL=postgresql+asyncpg://nil:nilpass@localhost:5432/nil_benchmark
export DATABASE_URL_SYNC=postgresql://nil:nilpass@localhost:5432/nil_benchmark
uvicorn app.main:app --reload --port 8000

cd frontend
npm install
npm run dev   # Starts on port 3000