FastAPI service for the conversational resume builder: sessions, turns, resumes, and light-optimization state, persisted in SQLite (pilot) or PostgreSQL (production).

Run locally

Python 3.11 or newer is required.

python -m pip install -r requirements.txt
cp .env.example .env
# Leave OPENAI_API_KEY empty for offline rules, or fill in the live LLM gateway values.
python -m uvicorn app.asgi:application --reload --port 8000

app.asgi:application wraps app.main:app and hides /docs, /redoc, and /openapi.json by default; set RESUME_AGENT_API_DOCS=1 to expose them (development only).

The runtime expects DATABASE_URL (PostgreSQL) and uses the resume_agent schema by default; override with RESUME_AGENT_DATABASE_SCHEMA. Run alembic upgrade head to create the tables, and python scripts/migrate_sqlite_to_postgres.py to move existing SQLite data. SQLite is used only when database_path is passed explicitly (tests, local pilot). CORS defaults to http://localhost:5173; set a comma-separated RESUME_AGENT_CORS_ORIGINS.

Set OFFERPAI_AUTH_BASE_URL to enable the OfferPai landing-token bridge. The frontend passes the in-memory landing token on every session request via Authorization: Bearer; the backend validates it with GET /api/public/checkLogin, loads GET /api/user/manage/info using the upstream Token cookie, and persists the account identity/default phone without persisting the token itself. Resume content uses a three-way OfferPai reconciliation baseline: remote-only changes are pulled, local-only changes are pushed, and concurrent changes return a conflict instead of overwriting.

The health check at GET /health is always open.

Tests

python -m pytest tests -q

Postgres-backed tests require RESUME_AGENT_TEST_DATABASE_URL; the rest run on SQLite temporary files. Tests force the rule-based LLM provider, so no API key is needed.