costs 0.1.19

Zero-config AI cost calculator per commit/model with liteLLM

AI Cost Tracker

💰 Track AI costs for your projects - This tool helps developers monitor AI usage costs across git commits.

Zero-config AI cost calculator per commit/model with liteLLM integration.

---

📊 AI Cost Tracking for This Project

This project tracks its own AI development costs.

Development Stats:

• 📝 18 commits across 1 day of active development
• ⏱️ ~6 hours estimated development time (accounting for overlapping work)
• 💰 AI Cost: Analyze with aicost auto-badge --repo .

pip install costs
aicost auto-badge --repo .

---

Track AI usage costs across your git commits with three flexible usage modes - no initial configuration required.

Features

• liteLLM Integration - Support for 100+ AI providers via liteLLM
• Default: Claude 4 Sonnet - Pre-configured with Anthropic's latest model
• Zero Config - Works out of the box, reads from .env file
• Smart Token Estimation - Accurate cost calculation using liteLLM tokenizers
• ROI Calculation - Track value generated vs AI costs
• Date Filtering - Analyze specific days, date ranges, or full history
• Auto Badges - Automatically generate and update cost badges in README
• Rich Reports - Markdown and HTML reports with visualizations

Installation

pip install costs

Quick Start

1. Initialize Configuration

aicost init
# Edit .env file to add your OpenRouter API key
echo "OPENROUTER_API_KEY=YOUR_KEY" >> .env

2. Run Analysis

# Uses defaults from .env (Claude 4 Sonnet)
aicost analyze --repo .

# Or specify directly
aicost analyze --repo . --model anthropic/claude-4-sonnet --api-key YOUR_KEY

Configuration

Create a .env file in your project root:

# Required: OpenRouter API key (https://openrouter.ai/keys)
OPENROUTER_API_KEY=YOUR_KEY
PFIX_MODEL=anthropic/claude-4-sonnet

Or use the built-in init command:

aicost init

Three Usage Options (Zero Config Required)

Option 1: BYOK (Bring Your Own Key) - Free

Use your own API key via OpenRouter. Costs calculated locally with real provider pricing.

# With OpenRouter key (default from .env)
aicost analyze --repo .

# Explicit key
aicost analyze --repo . --api-key YOUR_KEY

Supported models via liteLLM:

• anthropic/claude-4-sonnet (default)
• anthropic/claude-3.5-sonnet
• anthropic/claude-3.5-haiku
• openai/gpt-4o
• openai/gpt-4o-mini
• openrouter/qwen/qwen3-coder-next
• 100+ more via liteLLM

Option 2: Local/Ollama - Zero API Costs

No API key needed. Estimates based on diff size using local pricing.

aicost --repo . --mode local

Estimation formula: diff_chars / 4 * 0.0001$/M tokens

Date Filtering

Analyze commits for specific time periods:

# Analyze specific day
aicost analyze --repo . --date 2024-03-15

# Analyze date range
aicost analyze --repo . --since 2024-01-01 --until 2024-03-31

# Analyze all commits since repository creation
aicost analyze --repo . --full-history

Badge Generation

Generate and update cost badges in your README:

# Generate badge based on pyproject.toml configuration
aicost auto-badge --repo .

# Or manually
aicost badge --repo . --model anthropic/claude-4-sonnet

This adds a badge section to README showing total cost, AI commits, and model used.

Report Generation

# Generate markdown report with charts
aicost report --repo . --format markdown

# Generate HTML report
aicost report --repo . --format html

# Generate both and update README
aicost report --repo . --format both --update-readme

How It Works

1. Parse git history - Analyzuje commity z tagami [ai:model]
2. Estimate tokens - Używa heurystyki lub liteLLM do liczenia tokenów
3. Calculate cost - Mnoży tokeny × cena za model
4. Generate ROI - Szacuje oszczędność czasu (100 LOC/h × $100/h)

Why liteLLM?

• Universal API - Jedna składnia dla 100+ providerów
• Automatic routing - Fallback między providerami
• Cost tracking - Wbudowane liczenie tokenów
• OpenRouter - Dostęp do najnowszych modeli bez kont premium

Option 3: SaaS Subscription - Managed

Enterprise managed solution with dashboard and invoicing.

aicost --repo . --saas-token PLACEHOLDER

Usage Examples

# Initialize .env config
aicost init

# Analyze last 50 commits (uses .env defaults)
aicost analyze --repo . -n 50

# Use specific model via liteLLM
aicost analyze --repo . --model anthropic/claude-3.5-sonnet

# Analyze all commits (not just AI-tagged)
aicost analyze --repo . --all

# Export to custom file
aicost analyze --repo . --output my_costs.csv

# Estimate single diff
aicost estimate my_changes.patch

# Read diff from stdin
git diff HEAD~1 | aicost estimate -

Tagging AI Commits

Tag commits with [ai:model] for automatic tracking:

git commit -m "[ai:openrouter/qwen/qwen3-coder-next] Refactor authentication"
git commit -m "[ai:anthropic/claude-3.5-sonnet] Add payment integration"

Sample Output

🔍 Analyzing 100 commits from my-project...
🤖 Model: anthropic/claude-4-sonnet | Mode: byok

==================================================
📊 AI COST ANALYSIS - anthropic/claude-4-sonnet
==================================================
   Commits analyzed: 42
   Total cost:       $12.34
   Hours saved:      15.3h
   Value generated:  $1530.00
   ROI:              124x
==================================================
📁 Results saved to: ai_costs.csv

💡 Recent AI commits:
   a1b2c3d4 | $0.32 | [ai:claude-4-sonnet] Refactor...
   e5f6g7h8 | $0.45 | [ai:claude-4-sonnet] Add feature...

CSV Export Format

Column	Description
commit_hash	Short commit SHA
commit_message	Full commit message
author	Commit author name
date	ISO format datetime
cost	Calculated cost in USD
cost_formatted	Formatted cost string
model	AI model used
mode	Calculation mode (byok/local/saas)
tokens_input	Estimated input tokens
tokens_output	Estimated output tokens
hours_saved	Estimated hours saved
roi	ROI multiplier

Pricing Reference

Model	Input	Output
anthropic/claude-4-sonnet	$3/M	$15/M
anthropic/claude-3.5-sonnet	$3/M	$15/M
anthropic/claude-3.5-haiku	$0.8/M	$4/M
openai/gpt-4o	$5/M	$15/M
openai/gpt-4o-mini	$0.15/M	$0.6/M
openrouter/qwen/qwen3-coder-next	$0.50/M	$1.50/M
ollama/*	~$0.0001/M	~$0.0001/M

Business Model

Tier	Price	Features
BYOK	Free	Use your own OpenRouter API key
SaaS	$9/month	Unlimited, managed keys, dashboard, EU invoicing

Development

# Install with poetry
poetry install

# Run CLI
poetry run aicost analyze --repo ..

# Publish to PyPI
poetry publish --build

PHP Badge Service

Standalone PHP service for generating badges:

cd services/badge-service
composer install
php -S localhost:8080

Generate badges via API:

curl "http://localhost:8080/badge.php?cost=12.34&model=claude-4&commits=42"

CLI Commands

Command	Description
aicost init	Initialize .env configuration
aicost analyze	Analyze repository commits
aicost stats	Show repository statistics
aicost report	Generate markdown/HTML reports
aicost badge	Generate cost badge
aicost auto-badge	Auto-generate badge from pyproject.toml
aicost estimate	Estimate cost for single diff

📖 Automatic Badge Generation: See docs/AUTO_BADGE.md for GitHub Actions, pre-commit hooks, and CI/CD integration.

Environment Variables

Variable	Description	Default
OPENROUTER_API_KEY	OpenRouter API key	(required for BYOK)
PFIX_MODEL	Default model for calculations	anthropic/claude-4-sonnet

License

Licensed under Apache-2.0.