CathodeBench is a LiFePO4-only week-1 alpha for reviewing benchmark data extracted from cathode papers.
- Invite-only login
- One workspace per user
- PDF upload
- Page parsing
- Tier-1 LiFePO4 extraction with field-level evidence
- Review and approval UI
- CSV/JSON export
- QA metrics dashboard
- Deletion flow
- Redis-backed queue orchestration with worker entrypoint
- Document status polling for queued, parsing, extracting, completed, and failed states
- Persisted extraction progress with page and row counters
- Stronger LiFePO4 heuristic extraction fallback and ambiguity flags
- Session validation on page load
- Richer admin metrics for edit burden and confidence-vs-acceptance
- Docker packaging for API, worker, and web services
- Real Alembic-backed schema migrations
- Push-style document progress streaming for the review UI
apps/web: Next.js frontendapps/api: FastAPI backend and extraction pipelineschemas: Structured Outputs contractprompts: extraction and normalization promptssql: SQL migration starterinfra: local Docker wiring
- Copy
.env.exampleto.envand fill the values you need. - Start the full local stack from
infra:docker compose -f infra/docker-compose.yml up --build
- Open:
- web:
http://localhost:3000 - API:
http://localhost:8000 - MinIO console:
http://localhost:9001 - API startup now runs Alembic migrations automatically.
- web:
- If you prefer running app processes manually, start only the backing services:
docker compose -f infra/docker-compose.yml up -d postgres redis minio
- Install backend dependencies:
python -m venv .venv.\\.venv\\Scripts\\Activate.ps1pip install -r apps/api/requirements.txt
- Install frontend dependencies:
cd apps/webnpm install
- Run the API:
python -m uvicorn app.main:app --reload --app-dir apps/api
- Run the worker:
cd apps/apipython -m app.workers.run_worker
- Run the frontend:
cd apps/webnpm run dev
If OPENAI_API_KEY is unset, the API falls back to a deterministic heuristic extractor for local testing.
If you want to force synchronous local processing, set QUEUE_BACKEND=inline.
If you want to run migrations manually, use alembic -c apps/api/alembic.ini upgrade head from the repo root.