ai-cost-auditor

AI Cost Auditor

Track AI API costs, token usage, and prompt quality across all providers — Anthropic, OpenAI, Google, Mistral, and more.

Install

pip install ai-cost-auditor

With provider SDKs:

pip install "ai-cost-auditor[anthropic]"
pip install "ai-cost-auditor[openai]"
pip install "ai-cost-auditor[all]"

Quick Start

from ai_cost_auditor import CostTracker
import anthropic

tracker = CostTracker()
client  = tracker.wrap_anthropic(anthropic.Anthropic())

# Use exactly like the normal client — tracking is automatic
resp = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Explain async/await in Python"}]
)

# View stats
stats = tracker.get_stats(days=7)
print(f"Cost: ${stats['period']['total_cost_usd']:.4f}")

# Generate HTML report with charts
tracker.generate_report("report.html")

Features

• Cost tracking — automatic pricing for 30+ models
• Token tracking — input/output tokens per call, by day/model/provider
• Prompt quality — 5-dimension scoring (clarity, specificity, context, structure, efficiency)
• HTML reports — interactive Chart.js charts: cost over time, provider breakdown, model usage
• Language-agnostic — works with any provider via manual tracker.track()
• VSCode extension — live cost status bar + interactive dashboard

Supported Providers & Models

CLI

# Analyze prompt quality
ai-cost-auditor analyze "Write a function to validate email addresses"

# Show stats
ai-cost-auditor stats --days 7

# Generate report and open in browser
ai-cost-auditor report --days 30 --open

Manual Tracking (any provider)

tracker.track(
    provider="google",
    model="gemini-1.5-flash",
    input_tokens=300,
    output_tokens=120,
    prompt_text="Your prompt here",
)

License

MIT