ComputeCFO

Zero Dependencies

ComputeCFO's core uses only Python standard library + SQLite. No external packages required.

Optional: Install fastapi + uvicorn for the dashboard and API server.

Quick Start

[medium] premium_creep: Premium model usage increased from 20% to 65%

```

Examples

See examples/quickstart.py for a complete walkthrough covering all features.

Use Cases

• AI Chatbot — Track cost per conversation, optimize model selection
• Content Generation — Measure cost per output, calculate production ROI
• Code Assistant — Budget controls for team usage, per-developer tracking
• Research Agent — Monitor long-running agent costs, prevent runaway spending
• Multi-Model Pipeline — Compare provider costs, find the cheapest sufficient model
• Multi-Project Organization — Independent P&L per project, Alphabet-style

Option 1: Standalone Dashboard

```bash pip install computecfo fastapi uvicorn python -m computecfo.server # or: python server.py

Option 2: Python Library

pip install computecfo

```python from computecfo import CostTracker

tracker = CostTracker()

Record an API call (after your Claude/OpenAI/Gemini call)

tracker.record("claude-sonnet-4-20250514", input_tokens=1500, output_tokens=500, module="chatbot", action="respond", project="my-saas")

Before each API call:

check = budget.pre_call_check("claude-opus-4-20250514") if check["approved"]: model = check["model"] # might be downgraded to sonnet! else: print(f"Blocked: {check['reason']}") ```

Three protection levels: <div class="rdm-tbl-wrap"><table class="rdm-tbl"><thead><tr><th>Level</th><th>Trigger</th><th>Action</th></tr></thead><tbody><tr><td>Warning</td><td>80% of budget</td><td>Log warning</td></tr><tr><td>Critical</td><td>100% of budget</td><td>Auto-downgrade model</td></tr><tr><td>Circuit Break</td><td>150% of budget</td><td>Block all API calls</td></tr></tbody></table></div>

🔌 FastAPI Integration

```python from fastapi import FastAPI from computecfo import CostTracker from computecfo.api import create_router

app = FastAPI() tracker = CostTracker() app.include_router(create_router(tracker), prefix="/api/cost")

14 endpoints available:

GET /api/cost/summary?days=7&project=my-saas

GET /api/cost/by-module

GET /api/cost/by-model

GET /api/cost/by-project

GET /api/cost/daily-trend

GET /api/cost/recent

GET /api/cost/budget

GET /api/cost/estimate

GET /api/cost/roi

GET /api/cost/efficiency

GET /api/cost/prediction

GET /api/cost/savings

GET /api/cost/model-values

GET /api/cost/anomalies

GET /api/cost/report

```

Supported Models

Add custom models:

from computecfo.models import MODEL_PRICING

MODEL_PRICING["my-custom-model"] = {"input": 2.0, "output": 8.0, "provider": "custom"}