atlas

Multi-tenant platform for managing leads, configuring AI voice agents, running controlled calling campaigns, and measuring outcomes. *ATLAS is a working codename; branding is configurable via ATLAS_PRODUCT_NAME.*

Language
Python
Stars
0
Last updated

From the README

ATLAS

AI Voice Agent & CRM Platform

Status

Milestone State
1 Foundation ✅
2 Auth & CRM (API) ✅
3 Web app (CRM) ✅ Radix controls, AG Grid leads
4 Voice runtime, agents, calls ✅ 276 backend tests on PostgreSQL + 7 live runtime contract tests
5 Campaigns, calls, reports, flow canvas ✅
7 API keys, webhooks, phone numbers, actions, knowledge ✅
6, 8 Local models end-to-end, hardening ⬜ see docs/implementation-plan.md

Requirements

Tool Version
Docker Desktop / Engine 24+ (Compose v2)
Python 3.12 (installed automatically by uv)
uv 0.8+
Node.js 22 LTS (web app)
pnpm 10

First run

cp .env.example .env              # then set ATLAS_JWT_SECRET and ATLAS_SECRETS_ENCRYPTION_KEY
docker compose up -d postgres redis
cd services/api
uv sync
uv run alembic upgrade head
ATLAS_DEMO_PASSWORD='choose-one' uv run python -m app.seed   # optional synthetic demo data
uv run uvicorn app.main:app --reload --port 8080

Web app (second terminal):

cd apps/web
pnpm install
pnpm dev            # http://localhost:5173 (proxies /api to :8080)
pnpm gen:api        # regenerate src/types/api.d.ts after API changes

Leads Flow canvas Reports

Windows: every command above works in PowerShell. Or use the task runner: .\make.ps1 infra, .\make.ps1 dev-api, .\make.ps1 check. On Linux/macOS: make infra, make dev-api, ….

Quality gates

cd services/api
uv run ruff check app tests && uv run ruff format --check app tests
uv run mypy app          # strict
uv run pytest -q         # needs the compose postgres + redis (uses db atlas_test, redis db 15)
uv run alembic check     # models and migrations in sync

On a slow PC, run the API tests on the Oracle server instead (one file or the whole suite; the first run installs the dependencies there):

bash infra/scripts/remote_api_tests.sh tests/test_campaigns.py

Documentation

Brand assets (wordmark and mark as SVG and PNG, light and dark) live in docs/brand/. The web app renders the same geometry inline from apps/web/src/components/brand.tsx, filled with the current text colour.

Safety defaults

Real phone calls are disabled unless ATLAS_LIVE_CALLS_ENABLED=true and the campaign is launched by a user holding campaigns:launch_live. Operators are responsible for call disclosure, recording consent, opt-out handling, and local calling regulations.