ai-cost-tracker/README.md

AI Cost Tracker

Shared AI cost tracking service for Oliver Agency projects.

Tracks LLM usage costs across workspaces, teams, and projects. Provides a REST API for recording AI calls and an admin dashboard for analytics.

Stack

• Backend: FastAPI, MongoDB, Redis, Celery
• Frontend: React, Vite, TypeScript
• Auth: Azure AD SSO (+ dev login for local testing)
• Deploy: Docker Compose on optical-dev

Quick start

cp .env.example .env
# Fill in Azure AD credentials and secrets
docker compose -f infra/docker-compose.yml up -d

Admin UI: http://localhost:5174 API docs: http://localhost:8001/docs