spent 0.1.0__tar.gz

spent-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.pytest_cache/
+.ruff_cache/
+*.db
+.env
+.venv/
+venv/

spent-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,39 @@
+# Contributing to spent
+
+Thanks for your interest in contributing!
+
+## Setup
+
+```bash
+git clone https://github.com/loplop-h/spent.git
+cd spent
+pip install -e ".[dev]"
+```
+
+## Running Tests
+
+```bash
+pytest
+```
+
+## Code Style
+
+We use [ruff](https://github.com/astral-sh/ruff) for linting:
+
+```bash
+ruff check .
+ruff format .
+```
+
+## Adding a New Provider
+
+1. Create a new patch file in `spent/patches/` (see `openai_patch.py` for reference)
+2. Add the provider's model pricing to `spent/pricing.py`
+3. Import and call the patch in `spent/patches/__init__.py`
+4. Add tests
+
+## Pull Requests
+
+- Keep PRs focused on a single change
+- Include tests for new functionality
+- Update README if adding user-facing features

spent-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 maxhu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

spent-0.1.0/PKG-INFO

@@ -0,0 +1,241 @@
+Metadata-Version: 2.4
+Name: spent
+Version: 0.1.0
+Summary: See what your AI really costs. Zero code changes.
+Project-URL: Homepage, https://github.com/loplop-h/spent
+Project-URL: Repository, https://github.com/loplop-h/spent
+Project-URL: Issues, https://github.com/loplop-h/spent/issues
+Author: maxhu
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,anthropic,budget,cost,llm,monitoring,openai,optimization,tokens,tracking
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.9
+Requires-Dist: click>=8.0
+Requires-Dist: rich>=13.0
+Provides-Extra: all
+Requires-Dist: anthropic>=0.20; extra == 'all'
+Requires-Dist: openai>=1.0; extra == 'all'
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.20; extra == 'anthropic'
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Provides-Extra: openai
+Requires-Dist: openai>=1.0; extra == 'openai'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <h1 align="center">spent</h1>
+  <p align="center"><strong>See what your AI really costs. Zero code changes.</strong></p>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/spent/"><img src="https://img.shields.io/pypi/v/spent?style=flat-square" alt="PyPI"></a>
+  <a href="https://pypi.org/project/spent/"><img src="https://img.shields.io/pypi/pyversions/spent?style=flat-square" alt="Python"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License"></a>
+  <a href="https://github.com/loplop-h/spent/stargazers"><img src="https://img.shields.io/github/stars/maxhu/spent?style=flat-square" alt="Stars"></a>
+</p>
+
+---
+
+You're spending hundreds on LLM APIs every month. Do you know which calls cost what?
+
+**spent** tracks every token, every model, every dollar -- automatically. One command. No code changes. Beautiful reports.
+
+```
+$ spent run python app.py
+
+ ┌──────────────────────────────────────────┐
+ │  spent                    session a1b2c3 │
+ │                                          │
+ │  Total Cost:    $4.2731                  │
+ │  Tokens:        125,430  (98k in / 27k out)
+ │  API Calls:     47                       │
+ │  Duration:      2m 34s                   │
+ └──────────────────────────────────────────┘
+
+  Model                   Calls  Tokens     Cost     Share
+  gpt-4o                  12     84,200     $3.8100  ████████░░ 89%
+  gpt-4o-mini             31     38,100     $0.4200  █░░░░░░░░░ 10%
+  claude-sonnet-4-6        4      3,130     $0.0431  ░░░░░░░░░░  1%
+
+  Savings Opportunities: ~$2.1000
+    gpt-4o -> gpt-4o-mini: save $2.10 (55%) on 12 calls
+```
+
+## Quick Start
+
+```bash
+pip install spent
+```
+
+### Option 1: Zero code changes (recommended)
+
+Just prefix your command:
+
+```bash
+spent run python app.py
+spent run python -m pytest
+spent run --budget 5.00 python train.py
+```
+
+### Option 2: One line of code
+
+```python
+from spent import track
+from openai import OpenAI
+
+client = track(OpenAI())
+
+# Use normally -- costs tracked automatically
+response = client.chat.completions.create(
+    model="gpt-4o",
+    messages=[{"role": "user", "content": "Hello!"}],
+)
+# Exit summary printed automatically
+```
+
+Works with Anthropic too:
+
+```python
+from spent import track
+from anthropic import Anthropic
+
+client = track(Anthropic())
+```
+
+## Features
+
+| Feature | Status |
+|---------|--------|
+| OpenAI cost tracking | Done |
+| Anthropic cost tracking | Done |
+| Beautiful terminal dashboard | Done |
+| Per-model cost breakdown | Done |
+| Savings recommendations | Done |
+| Budget alerts | Done |
+| Session history | Done |
+| JSON/CSV export | Done |
+| Google AI tracking | Roadmap |
+| Auto model routing | Roadmap |
+| Team cost sharing | Roadmap |
+| CI/CD cost reports | Roadmap |
+
+## Commands
+
+```bash
+# Track costs (zero code changes)
+spent run python app.py
+
+# Set a budget alert
+spent run --budget 10.00 python app.py
+
+# Live dashboard (watches costs in real-time)
+spent dashboard
+
+# View cost reports
+spent report              # Recent sessions
+spent report --today      # Today's costs
+spent report --json       # Machine-readable
+spent report --csv        # Spreadsheet-ready
+
+# Clear all data
+spent reset
+```
+
+## How It Works
+
+**spent** transparently patches the OpenAI and Anthropic Python SDKs at import time. When your code calls `client.chat.completions.create(...)`, spent:
+
+1. Intercepts the call (before and after)
+2. Extracts token usage from the response
+3. Calculates cost using up-to-date pricing
+4. Stores the record in a local SQLite database
+5. Returns the original response unchanged
+
+Your code runs exactly the same. No API proxies. No network changes. No latency added to API calls themselves.
+
+Data stays on your machine at `~/.spent/data.db`.
+
+## Supported Models
+
+40+ models with up-to-date pricing:
+
+| Provider | Models |
+|----------|--------|
+| **OpenAI** | GPT-4o, GPT-4o-mini, GPT-4-Turbo, GPT-4, GPT-3.5-Turbo, o1, o3, o3-mini, o4-mini |
+| **Anthropic** | Claude Opus 4, Claude Sonnet 4, Claude Haiku 4, Claude 3.5/3 family |
+| **Google** | Gemini 2.5 Pro/Flash, 2.0 Flash, 1.5 Pro/Flash |
+| **DeepSeek** | DeepSeek Chat, DeepSeek Reasoner |
+| **Mistral** | Mistral Large, Mistral Small, Codestral |
+| **Groq** | Llama 3.3 70B, Llama 3.1 8B, Mixtral 8x7B |
+
+Unknown models are tracked with $0 cost (tokens still recorded).
+
+## Budget Alerts
+
+Set a budget and get warned when you exceed it:
+
+```bash
+# CLI
+spent run --budget 5.00 python app.py
+
+# Python
+from spent import track, configure
+configure(budget=5.00)
+client = track(OpenAI())
+```
+
+When the budget is exceeded:
+```
+[spent] BUDGET ALERT: $5.0231 spent (budget: $5.00)
+```
+
+## Why spent?
+
+| | spent | Manual tracking | LLM framework built-in |
+|---|---|---|---|
+| Code changes needed | 0 | Lots | Framework-specific |
+| Works across providers | Yes | Manual per-provider | Usually one provider |
+| Historical data | SQLite | Spreadsheets | In-memory only |
+| Savings recommendations | Automatic | You do the math | No |
+| Export formats | JSON, CSV | Copy-paste | Varies |
+| Privacy | 100% local | Depends | Often cloud |
+
+## Roadmap
+
+- [ ] **Google AI / Vertex tracking** -- Gemini model support
+- [ ] **Auto model routing** -- automatically use cheaper models for simple tasks
+- [ ] **Team dashboards** -- aggregate costs across team members
+- [ ] **CI/CD integration** -- cost reports in GitHub Actions / PR comments
+- [ ] **Ollama / local model tracking** -- track local inference costs (compute time)
+- [ ] **Web dashboard** -- browser-based cost explorer
+- [ ] **Slack / Discord alerts** -- budget notifications in team channels
+- [ ] **Cost anomaly detection** -- alert on unusual spending patterns
+
+## Contributing
+
+Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+```bash
+git clone https://github.com/loplop-h/spent.git
+cd spent
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT

spent-0.1.0/README.md

@@ -0,0 +1,203 @@
+<p align="center">
+  <h1 align="center">spent</h1>
+  <p align="center"><strong>See what your AI really costs. Zero code changes.</strong></p>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/spent/"><img src="https://img.shields.io/pypi/v/spent?style=flat-square" alt="PyPI"></a>
+  <a href="https://pypi.org/project/spent/"><img src="https://img.shields.io/pypi/pyversions/spent?style=flat-square" alt="Python"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License"></a>
+  <a href="https://github.com/loplop-h/spent/stargazers"><img src="https://img.shields.io/github/stars/maxhu/spent?style=flat-square" alt="Stars"></a>
+</p>
+
+---
+
+You're spending hundreds on LLM APIs every month. Do you know which calls cost what?
+
+**spent** tracks every token, every model, every dollar -- automatically. One command. No code changes. Beautiful reports.
+
+```
+$ spent run python app.py
+
+ ┌──────────────────────────────────────────┐
+ │  spent                    session a1b2c3 │
+ │                                          │
+ │  Total Cost:    $4.2731                  │
+ │  Tokens:        125,430  (98k in / 27k out)
+ │  API Calls:     47                       │
+ │  Duration:      2m 34s                   │
+ └──────────────────────────────────────────┘
+
+  Model                   Calls  Tokens     Cost     Share
+  gpt-4o                  12     84,200     $3.8100  ████████░░ 89%
+  gpt-4o-mini             31     38,100     $0.4200  █░░░░░░░░░ 10%
+  claude-sonnet-4-6        4      3,130     $0.0431  ░░░░░░░░░░  1%
+
+  Savings Opportunities: ~$2.1000
+    gpt-4o -> gpt-4o-mini: save $2.10 (55%) on 12 calls
+```
+
+## Quick Start
+
+```bash
+pip install spent
+```
+
+### Option 1: Zero code changes (recommended)
+
+Just prefix your command:
+
+```bash
+spent run python app.py
+spent run python -m pytest
+spent run --budget 5.00 python train.py
+```
+
+### Option 2: One line of code
+
+```python
+from spent import track
+from openai import OpenAI
+
+client = track(OpenAI())
+
+# Use normally -- costs tracked automatically
+response = client.chat.completions.create(
+    model="gpt-4o",
+    messages=[{"role": "user", "content": "Hello!"}],
+)
+# Exit summary printed automatically
+```
+
+Works with Anthropic too:
+
+```python
+from spent import track
+from anthropic import Anthropic
+
+client = track(Anthropic())
+```
+
+## Features
+
+| Feature | Status |
+|---------|--------|
+| OpenAI cost tracking | Done |
+| Anthropic cost tracking | Done |
+| Beautiful terminal dashboard | Done |
+| Per-model cost breakdown | Done |
+| Savings recommendations | Done |
+| Budget alerts | Done |
+| Session history | Done |
+| JSON/CSV export | Done |
+| Google AI tracking | Roadmap |
+| Auto model routing | Roadmap |
+| Team cost sharing | Roadmap |
+| CI/CD cost reports | Roadmap |
+
+## Commands
+
+```bash
+# Track costs (zero code changes)
+spent run python app.py
+
+# Set a budget alert
+spent run --budget 10.00 python app.py
+
+# Live dashboard (watches costs in real-time)
+spent dashboard
+
+# View cost reports
+spent report              # Recent sessions
+spent report --today      # Today's costs
+spent report --json       # Machine-readable
+spent report --csv        # Spreadsheet-ready
+
+# Clear all data
+spent reset
+```
+
+## How It Works
+
+**spent** transparently patches the OpenAI and Anthropic Python SDKs at import time. When your code calls `client.chat.completions.create(...)`, spent:
+
+1. Intercepts the call (before and after)
+2. Extracts token usage from the response
+3. Calculates cost using up-to-date pricing
+4. Stores the record in a local SQLite database
+5. Returns the original response unchanged
+
+Your code runs exactly the same. No API proxies. No network changes. No latency added to API calls themselves.
+
+Data stays on your machine at `~/.spent/data.db`.
+
+## Supported Models
+
+40+ models with up-to-date pricing:
+
+| Provider | Models |
+|----------|--------|
+| **OpenAI** | GPT-4o, GPT-4o-mini, GPT-4-Turbo, GPT-4, GPT-3.5-Turbo, o1, o3, o3-mini, o4-mini |
+| **Anthropic** | Claude Opus 4, Claude Sonnet 4, Claude Haiku 4, Claude 3.5/3 family |
+| **Google** | Gemini 2.5 Pro/Flash, 2.0 Flash, 1.5 Pro/Flash |
+| **DeepSeek** | DeepSeek Chat, DeepSeek Reasoner |
+| **Mistral** | Mistral Large, Mistral Small, Codestral |
+| **Groq** | Llama 3.3 70B, Llama 3.1 8B, Mixtral 8x7B |
+
+Unknown models are tracked with $0 cost (tokens still recorded).
+
+## Budget Alerts
+
+Set a budget and get warned when you exceed it:
+
+```bash
+# CLI
+spent run --budget 5.00 python app.py
+
+# Python
+from spent import track, configure
+configure(budget=5.00)
+client = track(OpenAI())
+```
+
+When the budget is exceeded:
+```
+[spent] BUDGET ALERT: $5.0231 spent (budget: $5.00)
+```
+
+## Why spent?
+
+| | spent | Manual tracking | LLM framework built-in |
+|---|---|---|---|
+| Code changes needed | 0 | Lots | Framework-specific |
+| Works across providers | Yes | Manual per-provider | Usually one provider |
+| Historical data | SQLite | Spreadsheets | In-memory only |
+| Savings recommendations | Automatic | You do the math | No |
+| Export formats | JSON, CSV | Copy-paste | Varies |
+| Privacy | 100% local | Depends | Often cloud |
+
+## Roadmap
+
+- [ ] **Google AI / Vertex tracking** -- Gemini model support
+- [ ] **Auto model routing** -- automatically use cheaper models for simple tasks
+- [ ] **Team dashboards** -- aggregate costs across team members
+- [ ] **CI/CD integration** -- cost reports in GitHub Actions / PR comments
+- [ ] **Ollama / local model tracking** -- track local inference costs (compute time)
+- [ ] **Web dashboard** -- browser-based cost explorer
+- [ ] **Slack / Discord alerts** -- budget notifications in team channels
+- [ ] **Cost anomaly detection** -- alert on unusual spending patterns
+
+## Contributing
+
+Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+```bash
+git clone https://github.com/loplop-h/spent.git
+cd spent
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT

spent-0.1.0/pyproject.toml

@@ -0,0 +1,67 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "spent"
+version = "0.1.0"
+description = "See what your AI really costs. Zero code changes."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [
+    { name = "maxhu" },
+]
+keywords = [
+    "llm", "ai", "cost", "tracking", "openai", "anthropic",
+    "tokens", "monitoring", "budget", "optimization",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: System :: Monitoring",
+]
+dependencies = [
+    "click>=8.0",
+    "rich>=13.0",
+]
+
+[project.optional-dependencies]
+openai = ["openai>=1.0"]
+anthropic = ["anthropic>=0.20"]
+all = ["openai>=1.0", "anthropic>=0.20"]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+    "ruff>=0.4",
+]
+
+[project.scripts]
+spent = "spent.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/loplop-h/spent"
+Repository = "https://github.com/loplop-h/spent"
+Issues = "https://github.com/loplop-h/spent/issues"
+
+[tool.ruff]
+target-version = "py39"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-v --tb=short"
+
+[tool.hatch.build.targets.wheel]
+packages = ["spent"]

spent-0.1.0/spent/__init__.py

@@ -0,0 +1,66 @@
+"""spent -- see what your AI really costs.
+
+Usage (zero code changes):
+    $ spent run python app.py
+
+Usage (programmatic):
+    from spent import track
+    from openai import OpenAI
+
+    client = track(OpenAI())
+"""
+
+from __future__ import annotations
+
+__version__ = "0.1.0"
+
+
+def track(client, *, budget: float | None = None):
+    """Wrap an LLM client to track all API costs.
+
+    Supports OpenAI and Anthropic clients. Returns the same client
+    with transparent cost tracking enabled.
+
+    Args:
+        client: An OpenAI() or Anthropic() client instance.
+        budget: Optional budget alert threshold in USD.
+
+    Returns:
+        The same client, now tracked.
+
+    Example:
+        from openai import OpenAI
+        from spent import track
+
+        client = track(OpenAI())
+        # Use client normally -- costs are tracked automatically.
+    """
+    from .tracker import Tracker
+    from .patches import apply_all
+
+    tracker = Tracker.get()
+    if budget is not None:
+        tracker.set_budget(budget)
+
+    apply_all()
+    return client
+
+
+def configure(*, budget: float | None = None, quiet: bool = False) -> None:
+    """Configure the global tracker.
+
+    Args:
+        budget: Budget alert threshold in USD.
+        quiet: Suppress the exit summary.
+    """
+    from .tracker import Tracker
+    tracker = Tracker.get()
+    if budget is not None:
+        tracker.set_budget(budget)
+    tracker.quiet = quiet
+
+
+def summary() -> dict:
+    """Get the current session cost summary as a dict."""
+    from .tracker import Tracker
+    return Tracker.get().summary()