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.
Star 增长趋势（本站收录历史）
headroomlabs-ai/headroom
深度介绍
它是什么
Headroom 是一个在内容进入 LLM 之前做压缩的 Python 工具库，专门处理工具输出、日志、文件和 RAG 分块，提供库、代理、MCP Server 三种接入形态。
核心亮点
- 编码 Agent 场景可减少约 20% token，JSON 类内容压缩率达 60–95%，且答案质量不变
- 同时支持库调用、HTTP 代理和 MCP 三种集成方式，覆盖 LangChain、FastAPI 等生态
- Apache-2.0 协议，兼容 OpenAI、Anthropic、Claude Code、Cursor
为什么火
上下文窗口和 token 成本是 Agent 落地的核心瓶颈。Headroom 切中"上下文工程"痛点，压缩比可量化，接入成本低，单日 555 星说明需求真实且紧迫。
适合谁用
构建编码 Agent、RAG 管道或高频调用 LLM 的团队；对 token 账单敏感、上下文经常爆窗的开发者。
快速上手
pip install headroom
作为库调用压缩函数，或启动代理/MCP Server 接入现有链路，无需改动业务逻辑。