This package owns the FastAPI service, durable ingestion worker, PageIndex integration, retrieval graph, guarded SQL, provider accounting, Alembic migrations, evaluation tooling, and Python tests. The root Makefile is the authoritative command surface.
From the repository root:
make api-install
make api-test
make api-check
TEST_POSTGRES_PORT=55433 make test-integration-stackUse uv --project apps/api … for direct package commands from the repository root, or uv … from this directory. Unit, type, migration-render, and isolated PostgreSQL tests are provider-free. Live ingestion, chat, pilots, and evaluation execution call DeepSeek and require separate cost authorization.
Read the project overview, command reference, test tiers, and evaluation workflow before changing cross-package behavior.