Technology stack
Atlas is a Python backend with durable workflow orchestration, dual relational + graph persistence, and a React single-page frontend.
Backend
| Concern | Technology | Notes |
|---|---|---|
| API framework | FastAPI (async) | 26 domain routers, src/api/main.py entrypoint |
| Language | Python 3.11+ | async/await throughout |
| Relational DB | PostgreSQL 15 | ontology + operational data, Row-Level Security |
| Property graph | Neo4j 5.x | relationship queries; Apache AGE client also present |
| Cache / sessions | Redis 7 | rate-limit tokens, caching |
| Object storage | MinIO (S3-compatible) | report documents, tenant-prefixed buckets |
| Workflows | Temporal | durable investigation orchestration |
| Migrations | Flyway | versioned SQL migrations applied at startup |
| Auth | Keycloak (OIDC) | per-tenant realms, JWT validation |
| LLM access | OpenRouter / Anthropic / OpenAI | per-tenant keys, src/pipelines/model_factory.py |
| Tools | MCP servers | Brightdata, Exa, Tavily, Google Maps |
| LLM pipelines | LangGraph | agentic crews, src/pipelines/ |
| Tracing | Langfuse | LLM call tracing, src/observability/ |
| Encryption | AES-GCM | tenant credential encryption at rest, src/security/ |
Frontend
| Concern | Technology | Notes |
|---|---|---|
| Framework | React 18 + TypeScript | SPA, frontend/src/App.tsx |
| Build | Vite 7 | dev proxy to API + Keycloak |
| Design system | Palantir Blueprint 5 | dark theme (bp5-dark) |
| Server state | TanStack React Query 5 | tenant-scoped persistent cache |
| Client state | Zustand 5 | evaluation, mapping, preview stores |
| Routing | React Router 7 | tenant-aware protected routes |
| Auth | keycloak-js 26 | PKCE, same-origin proxy |
| Graph viz | Cytoscape | knowledge-graph and lineage views |
| Charts | Recharts | portfolio and risk dashboards |
| Forms | react-hook-form + Zod | typed validation |
| Testing | Vitest + Testing Library + axe-core | unit + a11y |
Deployment
| Concern | Technology |
|---|---|
| Local | Docker Compose (docker-compose.yml, docker-compose.dev.yml) |
| Production | Kubernetes via Helm charts (charts/api, charts/ui, charts/worker) |
| Ingress | nginx + cert-manager (Let's Encrypt) |
| Docs site | Docusaurus on Cloudflare Pages (this site) |
How the pieces relate
For exact service names, ports, and dependencies see Operations → Deployment and Reference → Ports.