headroomlabs-ai / headroom

∴ 是什么

Headroom 是一个用于压缩 AI 代理读取内容的库、代理和 MCP 服务器。它包含 Python 和 TypeScript 库、零代码修改的代理、可包装多种编码代理的 CLI 命令，以及提供压缩、检索和统计功能的 MCP 服务器。压缩在本地运行，不发送任何提示或文件内容。

∴ 解决什么问题

• ›减少发送给 LLM 的令牌数量，降低成本和延迟
• ›压缩工具输出、日志、RAG 块、文件和对话历史
• ›减少模型写回的输出令牌
• ›跨代理共享记忆，避免重复存储

∴ 怎么上手

1. 01uv tool install --python 3.13 "headroom-ai[all]"
2. 02headroom deploy
3. 03headroom wrap claude
4. 04headroom proxy --port 8787
5. 05headroom doctor
6. 06headroom perf

∴ 适合谁

使用 Claude Code、Cursor、Codex 等编码代理的开发者，以及构建 LLM 应用的 Python 或 TypeScript 开发者

∴ 要点

• ›压缩在本地运行，数据不会发送到外部
• ›支持 Python 和 TypeScript 库、代理、MCP 服务器
• ›可逆压缩（CCR），原始内容本地缓存并按需检索
• ›输出令牌缩减功能，包括措辞引导和努力路由
• ›基于 Apache-2.0 许可证
• ›包含基准测试，证明在代码搜索、SRE 调试等场景下可节省 21%-57% 的令牌

∴ 在榜记录

GitHub Trending 今日榜的每日存档，日期按北京时间。2026-10-19 首次上榜，累计在榜 1 天，最高第 7 名。