Headroom
headroomlabs-ai/headroomRevisado por IA
Verificado pelo RepoPicks Radar em
O que é Headroom?
O Headroom fica entre seu agente de codificação com IA e o modelo, e comprime o que passa por ali: saída de ferramentas, logs, arquivos, resultados de busca e histórico de chat. Você pode usá-lo como biblioteca Python ou TypeScript, como proxy local para o qual seu agente aponta, ou como servidor MCP dentro do Claude Code, Codex, Cursor e outros. A compressão acontece na sua própria máquina. É uma ferramenta para desenvolvedores: você instala com pip ou uv e roda comandos. Os próprios testes do repositório mostram de 21% a 57% menos tokens, dependendo de quão repetitivo é o texto.
Headroom é grátis e de código aberto (Apache-2.0) e pode substituir Compresr e The Token Company.
Quão fácil é instalar Headroom?
C · instalar 1 ou 2 ferramentas · Windows
- Windows C
- macOS C
- Linux C
Nos três sistemas você precisa de Python 3.11 ou mais recente e do terminal: `pip install "headroom-ai[all]"` (ou `uv tool install`), e depois comandos como `headroom wrap claude` ou `headroom proxy --port 8787`. Há wheels prontos para Windows, Linux e Apple Silicon, então nada precisa ser compilado; em Macs com Intel o README manda você para a instalação via Docker, que é mais difícil.
Headroom no GitHub
- Estrelas
- 79.308em 10 de nov. de 2026
- Downloads
- 17.1931.439 na semana
- Crescimento
- +557estrelas em 7 dias
Estrelas ao longo do tempo
Fatos
- Roda em
- Windows, macOS, Linux
- Você precisa instalar
- Python
- Para compilar a partir do código
- Python, Docker, Placa de vídeo, Rust
- Espaço em disco
- 15 MB–45 MB · pelo instalador
- Contas ou chaves
- 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)
- Custo
- Grátis · Apache-2.0 e de uso gratuito. A mesma empresa vende um "Headroom Enterprise" fechado com mais economia; você continua pagando ao seu próprio provedor de modelo pelos tokens que restarem.
- Licença
- Apache-2.0 (Permissiva)
- Pode substituir
- Compresr, The Token Company
- Última mudança no GitHub
- 10 de nov. de 2026
Sinais de risco de Headroom (9)
- AtençãoComando de instalação executa script da internet
O comando de instalação direciona um script remoto para o shell: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
checagem automática
- AtençãoTelemetria ativada por padrão
"Telemetry" do README.md: "An anonymous beacon is on by default. It reports how compression behaved: ratios, counters, provider and model IDs, OS and architecture." Diz que prompts e código nunca são enviados, e você pode desligar isso com HEADROOM_BEACON=off, HEADROOM_TELEMETRY=off, DO_NOT_TRACK=1 ou HEADROOM_OFFLINE=1.
revisão por IA
- AtençãoVê todos os prompts e tokens do provedor
Por design, toda requisição ao modelo passa por esse proxy local, e no caso do Copilot ele também lida com credenciais: README.md, "headroom copilot-auth login stores a Headroom-specific Copilot OAuth token" e "The short-lived upstream Copilot token is held only in the proxy process." Qualquer coisa que consiga ler esse processo consegue ler seus prompts e tokens.
revisão por IA
- AtençãoPlano de dados aberto se exposto
Cabeçalho do 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." O arquivo que vem por padrão vincula tudo a 127.0.0.1 para evitar isso.
revisão por IA
- AtençãoEdita a configuração de outras ferramentas
README.md: `headroom wrap` "installs Serena for semantic code navigation" como servidor MCP em `~/.claude.json`, "injects config" para OpenCode, Cline e Continue, escreve o seletor de modelo do Claude Code com `--1m`, e `headroom learn` escreve correções em CLAUDE.local.md, CLAUDE.md, AGENTS.md, GEMINI.md ou GROK.md. Existe um comando `unwrap` para desfazer isso.
revisão por IA
- InfoA economia depende muito do conteúdo
A descrição do repositório afirma "60-95% fewer tokens for JSON", enquanto os próprios quatro cenários de referência do README.md mostram 21%, 57%, 42% e 30%, e o texto acrescenta: "prose and already-dense output compress very little". O número de 31.7% de tokens de saída é marcado como "[estimated]" pela própria ferramenta.
revisão por IA
- InfoA versão gratuita é deliberadamente mais fraca
"Headroom for teams" do README.md: "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."
revisão por IA
- InfoBeta com lançamentos muito rápidos
O pyproject.toml marca isso como "Development Status :: 4 - Beta" na versão 0.42.0, e o GitHub mostra 175 lançamentos para um repositório criado em 2026-01-07, com 471 issues abertas. As coisas mudam semana a semana.
revisão por IA
- InfoInstalação ou execução baixa modelos e binários
A seção "Corporate networks" do README.md lista dois servidores de download que ele acessa por conta própria: cdn.pyke.io para o ONNX Runtime usado pelo núcleo em Rust, e huggingface.co para o modelo kompress-base. Também observa que os recursos de ONNX precisam de um processador com AVX2 em x86 e recorrem a métodos mais simples quando ele não existe.
revisão por IA
As evidências aparecem no idioma original.
O que o Radar não conseguiu verificar em Headroom
- Se as respostas realmente permanecem iguais com seus próprios prompts e ferramentas
- O que o beacon anônimo envia na prática
- O uso real de disco depois que os modelos, o cache local de texto original (CCR) e os bancos de dados de memória se enchem
- Quanto dinheiro isso realmente economiza na sua conta, o que depende da sua carga de trabalho
- Se todo agente listado ainda funciona com a versão atual, dado o ritmo de lançamentos