RepoPicks Radar

每天约 23:30 UTC 更新

指南

Headroom

headroomlabs-ai/headroomAI 已审核

RepoPicks Radar 检查于

Headroom 是什么?

Headroom位于你的AI编程助手和模型之间,压缩所有经过的内容:工具输出、日志、文件、搜索结果和聊天记录。你可以把它当作Python或TypeScript库使用,当作你的助手指向的本地代理,或者作为Claude Code、Codex、Cursor等工具里的MCP服务器。压缩过程在你自己的机器上完成。这是一个开发者工具:用pip或uv安装,然后运行命令。仓库自己的基准测试显示,根据文本的重复程度不同,能减少21%到57%的token。

Headroom 免费开源(Apache-2.0),可以替代 Compresr和The Token Company。

Headroom 安装有多容易?

C · 需要安装 1–2 个工具 · Windows

  • Windows C
  • macOS C
  • Linux C

在这三个系统上你都需要Python 3.11或更新版本,以及终端:`pip install "headroom-ai[all]"`(或`uv tool install`),然后运行像`headroom wrap claude`或`headroom proxy --port 8787`这样的命令。Windows、Linux和Apple Silicon都有现成的wheel包,不需要编译;在Intel芯片的Mac上,README会让你改用Docker安装,这更难一些。

Headroom 的 GitHub 数据

星标
79,3082026年11月10日
下载量
17,193本周 1,439
增长
+5577 天内新增星标

星标变化

78,80079,00079,20079,400 11月4日11月6日11月8日11月10日 78,80079,00079,20079,400 11月4日11月7日11月10日

事实

可运行于
Windows, macOS, Linux
需要安装
Python
从源码编译需要
Python, Docker, 显卡, Rust
磁盘空间
15 MB–45 MB · 根据安装程序
账号或密钥
Your own model provider (Anthropic, OpenAI, Bedrock and others) — the key you already use passes through the proxy, Other (HEADROOM_PROXY_TOKEN) — a password you make up, needed only if you open the proxy to your network, GitHub (only for the Copilot subscription mode)
费用
免费 · Apache-2.0许可,免费使用。同一家公司出售一个闭源的"Headroom Enterprise",能省得更多;剩下的token你仍然需要向你自己的模型服务商付费。
许可证
Apache-2.0 (宽松型)
GitHub 上的最近改动
2026年11月10日

Headroom 的风险信号 (9)

  • 注意安装命令会运行来自网络的脚本

    安装命令把一个远程脚本直接管道传给shell执行:curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

    自动检查

  • 注意默认开启遥测

    README.md的"Telemetry"部分:"An anonymous beacon is on by default. It reports how compression behaved: ratios, counters, provider and model IDs, OS and architecture." 它说提示词和代码永远不会被发送,你可以用HEADROOM_BEACON=off、HEADROOM_TELEMETRY=off、DO_NOT_TRACK=1或HEADROOM_OFFLINE=1关闭它。

    AI 审核

  • 注意能看到所有提示词和服务商的令牌

    按设计,每个发往模型的请求都要经过这个本地代理,对于Copilot,它还负责处理凭据:README.md,"headroom copilot-auth login stores a Headroom-specific Copilot OAuth token",以及"The short-lived upstream Copilot token is held only in the proxy process." 任何能读取该进程的东西都能读取你的提示词和令牌。

    AI 审核

  • 注意暴露后数据层是开放的

    docker-compose.yml文件开头:"None of these three services authenticates inbound callers by default: the proxy's /v1/* data plane is open unless HEADROOM_PROXY_TOKEN is set, Qdrant has no API key... Publishing them on 0.0.0.0 therefore hands any peer on your network a relay through the proxy plus direct read/write on the embeddings and graph derived from your prompts." 默认提供的文件把所有服务都绑定在127.0.0.1上,以避免这种情况。

    AI 审核

  • 注意修改其他工具的配置

    README.md:`headroom wrap`会把Serena作为MCP服务器"installs Serena for semantic code navigation"安装进`~/.claude.json`,为OpenCode、Cline和Continue"injects config",用`--1m`写入Claude Code的模型选择器,而`headroom learn`会把修正写进CLAUDE.local.md、CLAUDE.md、AGENTS.md、GEMINI.md或GROK.md。有一个`unwrap`命令可以撤销这些改动。

    AI 审核

  • 信息节省幅度高度依赖内容类型

    仓库简介宣称"60-95% fewer tokens for JSON",而README.md自己的四个基准测试场景显示的是21%、57%、42%和30%,文中还补充说:"prose and already-dense output compress very little"。31.7%的输出token数字被工具自己标记为"[estimated]"。

    AI 审核

  • 信息免费版被刻意限制得更弱

    README.md的"Headroom for teams"部分:"Headroom OSS is a framework. It was built to show what's possible on one developer's laptop, so it saves less than it could. We are building bigger savings for teams and enterprises in Headroom Enterprise."

    AI 审核

  • 信息测试版本但发行非常频繁

    pyproject.toml把它标记为"Development Status :: 4 - Beta",版本号是0.42.0,而GitHub显示这个创建于2026-01-07的仓库已经有175次发行,471个未解决的issue。事情每周都在变化。

    AI 审核

  • 信息安装或运行时下载模型和二进制文件

    README.md的"Corporate networks"部分列出了它会自行访问的两个下载源:cdn.pyke.io,用于Rust核心所用的ONNX Runtime;huggingface.co,用于kompress-base模型。文中还提到ONNX相关功能在x86上需要支持AVX2的处理器,没有的话会退回到更简单的方法。

    AI 审核

证据以原始语言显示。

Radar 无法验证的 Headroom 相关内容

  • 在你自己的提示词和工具上,回答是否真的保持不变
  • 匿名信标实际上发送了什么内容
  • 模型、本地原文缓存(CCR)和记忆数据库都填满之后的实际磁盘占用
  • 它实际上能在你的账单上省多少钱,这取决于你的工作负载
  • 考虑到发行节奏,列出的每个助手是否都还能配合当前版本使用

类似项目

RepoPicks 应用

即将推出:用 RepoPicks 应用一键安装。

下载之前

在 GitHub 上查看版本页面