Skip to main content

Component Map

app/main.py​

App startup, middleware, logging, health of the overall FastAPI process.

app/api/​

Route handlers and request/response schemas.

Important route groups:

  • auth
  • users
  • presets
  • contents
  • runs
  • credits
  • provider keys
  • admin

app/auth/​

Authentication middleware and the filesystem-backed user registry.

This is where session-token auth and membership DB-path resolution meet.

app/infra/db/​

Encrypted per-user DB engine creation, session management, models, repositories, and shared credits DB support.

app/security/​

DB-key cache, encryption helpers, provider-key encryption, and request-time key injection.

app/services/​

Business logic that does the heavy lifting:

  • run execution
  • config building
  • GitHub input import
  • results reading
  • export building
  • log writing and reading

app/evaluation/​

Evaluation logic and report generation.

app/adapters/​

Generator implementations and adapter-specific logic for providers and pipelines.