1.9 KiB
Resume Agent backend
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.