headroomlabs-ai/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.
深度介绍
它是什么
Headroom 是一个在数据进入 LLM 之前做压缩的中间层。它压缩工具输出、日志、文件和 RAG 分块，让同样的答案消耗更少的 token。
核心亮点
- 编码 agent 场景减少约 20% token，JSON 类数据减少 60–95%
- 三种形态：Python 库、代理（proxy）、MCP server，适配不同接入方式
- 主打“same answers”——压缩不牺牲回答质量
为什么火
上下文窗口和 token 成本是 agent 落地的核心瓶颈。Headroom 直接切中痛点，且对 Claude Code、Cursor、LangChain 等主流工具链友好，接入成本低，单日 300+ star 说明社区对“省 token”需求强烈。
适合谁用
构建 coding agent、RAG 管线的开发者；被长日志、大 JSON 撑爆上下文窗口的团队；想在不改 prompt 逻辑的前提下降低 API 成本的工程团队。
快速上手
pip install headroom
可作为库直接调用压缩函数，或启动 proxy 拦截请求，也可注册为 MCP server 供 agent 调用。Apache-2.0 许可，商用友好。