TokenBurn
htopfor your LLM spend — proxy-only.
TokenBurn is a local-first HTTP proxy for LLM spend visibility and control.
Route OpenAI-, Anthropic-, and Gemini-compatible traffic through a local proxy. TokenBurn logs usage locally, attributes cost by model/provider/program/tag, and turns raw traffic into actionable waste reports.
No hosted backend. No account. No prompt egress by default.
Install
pip install "tokenburn[proxy]"
tokenburn proxy setup
tokenburn proxy start --background
After setup, clients that support base URL overrides can route through TokenBurn with no app-specific SDK integration.
What it does
- Proxy-based capture — intercepts LLM traffic at the HTTP layer
- Cross-language — works with Python, TypeScript, Go, curl, and anything else that can point at a base URL
- Cross-provider — OpenAI, Anthropic, Gemini
- Local logs — normalized JSONL logs under
~/.tokenburn/logs/ - Spend reports — model, provider, endpoint, program, and tag breakdowns
- Waste detection — highlights expensive patterns worth fixing first
- Shareable output — terminal and exported reports
Core commands
tokenburn proxy setup
tokenburn proxy start --background
tokenburn proxy status
tokenburn proxy stop
tokenburn report
tokenburn gain
tokenburn share --open
tokenburn doctor
Product direction
TokenBurn is proxy-only.
That means the product lives at the proxy boundary rather than inside application runtimes.
The product lives at the network boundary, not inside app SDKs.
Repo docs
PROXY_TFF.md— proxy technical designSPEC.md— product and positioningkeche.md— project operating briefCLAUDE.md— maintainer workflow notes
License
MIT
Metadata
Release files for tokenburn 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| tokenburn-0.2.0.tar.gz | 147.6 kB | Without provenance | Details for tokenburn-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| tokenburn-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for tokenburn-0.2.0-py3-none-any.whl |
Total release size: 316.5 kB
Release files / tokenburn-0.2.0.tar.gz
| Download URL | tokenburn-0.2.0.tar.gz |
|---|---|
| Size | 147.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4befdc67be85192fa93ba6f42de9b814f7dafa5da06ec76292e1be82adf4098d
|
|
BLAKE2b-256 checksum How to use checksums |
eedcacd64f20303678444f2f763be852781c1c4d8d45a57481d5425a2f22a5a9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Release files / tokenburn-0.2.0-py3-none-any.whl
| Download URL | tokenburn-0.2.0-py3-none-any.whl |
|---|---|
| Size | 168.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d17859e82fbe2d07fe6ef7fe878bcf60b26813da42fd6e1ace1085b306303170
|
|
BLAKE2b-256 checksum How to use checksums |
0e7e0e10ef1f46c3c0285a534528006102a2c884a3ec2792b1e32822a742db8f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Security for tokenburn 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.