TraceroAI

Docker Compose

One command runs the whole stack on your machine or a server: Postgres, Redis, the API, the worker and the dashboard.

Terminal
git clone https://github.com/chinmai-sd-123/TraceroAI.git
cd TraceroAI
docker compose -f infra/docker-compose.yml up --build
ServiceWhat it isAddress
postgresEverything TraceroAI storesport 5432
redisThe evaluation queue and rate limitsport 6379
migrateBrings the schema up to date, then exits; the API and worker wait for it
apiThe FastAPI servicehttp://localhost:8000 (API docs at /docs)
workerRuns the LLM judge for queued traces
webThe dashboard and these docshttp://localhost:3000
demoOnly with --profile demo: loads the demo data once

The judge#

Export the provider settings before up and they reach the API and the worker:

Terminal
export TRACEROAI_OPENAI_API_KEY=sk-...
export TRACEROAI_JUDGE_MODEL=gpt-4o-mini          # optional
export TRACEROAI_JUDGE_BASE_URL=...               # optional: another OpenAI-compatible provider
docker compose -f infra/docker-compose.yml up -d

Without a key, traces get the quick checks only, and every diagnosis is marked Preliminary.

Demo data#

Terminal
docker compose -f infra/docker-compose.yml --profile demo up --build

Loads 30 recorded runs, three recovery runs and an experiment into a demo project. Running it again changes nothing. Remove it with:

Terminal
docker compose -f infra/docker-compose.yml run --rm demo python -m app.demo --remove

Only the databases#

To run the API or the tests outside Docker:

Terminal
docker compose -f infra/docker-compose.yml up -d postgres redis

Before it's reachable from a network#

The stack starts in development mode, where API keys are optional. Read the Production checklist first.