Home Projects headroom
headroom
Python

headroom

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.

by headroomlabs-ai · GitHub
Top 5% most starred in the catalogue
Stars
Forks
License
Created
Last commit
Category
Language
agentaianthropicApache-2.0Python
View on GitHub
In plain words

Reduce the size of outputs and logs before they reach the language model, saving processing time and resources.

From the README

Install
uv tool install "headroom-ai[all]"
command -v headroom

Excerpts from the project README on GitHub. Copyright and licensing remain with the respective authors.

You maintain this project?

Claim its page: indexed whatever its rank, translated into six languages, and enriched with what you write yourself.

Claim this page →
headroom — GitHub preview card
📈 Star history
68k52k
2026-06-272026-08-31
📈 Track headroom

Get an email alert on its next release or when it starts trending — never miss the moment.

Free · no card · unsubscribe anytime
Get email alerts →
📄 About

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.

headroom has 68.1k stars on GitHub. It has been forked 5.3k times. headroom is written mainly in Python. It has been in active development since 2026. headroom is available under the Apache-2.0 license. Its main topics are agent, ai, anthropic, claude-code.

Frequently asked questions

What is headroom?

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.

Is headroom open source?

headroom is an open-source project. It is released under the Apache-2.0 license.

Is headroom free?

Yes. headroom is free and open source — you can use, modify and self-host it.

What license does headroom use?

headroom is available under the Apache-2.0 license.

What language is headroom written in?

headroom is written mainly in Python.

🏅 Maintainer of this project?
olud.ai badge — headroom

Add this live badge to your README — your GitHub stars and directory rank, refreshed daily.

[![olud.ai](https://olud.ai/badge.php?tool=headroomlabs-ai-headroom)](https://olud.ai/project/headroomlabs-ai-headroom.html)
More badge options →
🧬 Related projects🧬 View the DNA map →