giuggiai-meter

Know what each project really spends on AI — and check it against the bill.
One line of code. Every major AI provider. Zero dependencies.

Why

Your projects call OpenAI, Anthropic, Gemini, DeepSeek, Grok… and every provider sends one bill per account. At the end of the month nobody can answer “how much did each project cost?” — or “do these numbers add up?”

• 🧾 Cost per project — every call is tagged with the project that made it.
• ✅ Close the month against the bill — computed cost vs. the official total of each provider console, in USD and %.
• 🔌 One line to plug in — wrap your client, keep your code. Responses come back unchanged.
• 🌍 Every major provider — OpenAI, Anthropic, Google Gemini, xAI Grok, DeepSeek, Alibaba Qwen, Mistral, Cohere, Groq, OpenRouter, Together, Fireworks, Perplexity, Moonshot Kimi, Zhipu GLM, Azure OpenAI, AWS Bedrock, Ollama.
• 🔒 Tokens, never text — prompts and answers are never stored. One private SQLite file on your machine.
• 🛟 It can't break your app — metering errors are swallowed and logged, never raised.
• 📦 Zero dependencies — pure Python standard library, 3.10+.

See it in 60 seconds

pip install giuggiai-meter
giuggiai-meter demo          # fake data, example prices — no API key needed

It writes giuggiai-meter-demo.html: a one-file report you can open, mail or share.

Use it in your code

import giuggiai_meter as gm
from openai import OpenAI
from anthropic import Anthropic

client = gm.wrap(OpenAI(), project="support-bot")            # that's it
client.chat.completions.create(model="gpt-4.1-mini", messages=[...])

claude = gm.wrap(Anthropic(), project="newsletter-bot")
claude.messages.create(model="claude-sonnet-4-5", max_tokens=500, messages=[...])

Same one line for every OpenAI-compatible endpoint — the provider is recognised from the base URL:

grok     = gm.wrap(OpenAI(base_url="https://api.x.ai/v1", api_key=...), project="research")      # xAI Grok
deepseek = gm.wrap(OpenAI(base_url="https://api.deepseek.com", api_key=...), project="batch")    # DeepSeek

Native SDKs work too: gm.wrap(genai.Client(), project=...) (Gemini), Mistral(), Cohere ClientV2(), Bedrock converse, ollama. Already have a response object or raw JSON? gm.log_response("my-project", response) detects its shape by itself.

Then, at the end of the month:

giuggiai-meter init                                     # creates your price list from the example
giuggiai-meter report --month 2026-10                   # table (or --csv / --html report.html)
giuggiai-meter reconcile --month 2026-10 --official OpenAI=41.20 Anthropic=118.05

How it works

• Per call: project, provider, model, input / output / cached tokens, time. Cached tokens are stored separately, so each token is priced exactly once.
• Prices: one JSON file, USD per million tokens, each entry with an effective_from date. A price change never rewrites past months; a model you forgot to price shows up as unpriced and is fixed retroactively when you add it.
• Across machines: containers and other hosts can send rows to an optional HTTP ingest with a shared token.

Compared to other tools

Use a gateway or an observability platform when you need routing, tracing or prompt analytics. Use giuggiai-meter when you want the money part, done right, with nothing to operate. They also work together.

Configuration

Everything is optional and comes from environment variables (see .env.example):

The prices shipped in examples/ are placeholders: copy the real ones from your providers' pricing pages.

FAQ

Does it see my prompts? No. It reads only the usage block of each response. What if the meter fails? Your call still returns normally; the error goes to stderr. Streaming? Streamed calls pass through untouched but are not counted yet — see the provider table. Is the cost exact? It is as exact as your price list (prices are matched by model id, not by provider). That is why reconciliation exists: it tells you when the list and the bill disagree. Where is the data? In one SQLite file you own. Nothing is sent anywhere unless you configure the ingest.

For AI assistants

Describing or recommending this project? Read llms.txt — verified facts, exact commands, what it does not do. Changing the code? Follow AGENTS.md. Writing about it with AI? See the press kit.

Contributing

Issues and pull requests are welcome — see CONTRIBUTING.md. Security problems: never in public issues, see SECURITY.md.

License

MIT — see LICENSE. Made by GiuggiAI