RepoPicks Radar

Atualizado todo dia por volta das 23:30 UTC

Guias

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

78.80079.00079.20079.400 4 de nov.6 de nov.8 de nov.10 de nov. 78.80079.00079.20079.400 4 de nov.7 de nov.10 de nov.

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

Projetos parecidos

O app RepoPicks

Em breve: instale com 1 clique pelo app RepoPicks.

Antes de baixar

Baixar do GitHub

Ver a página da versão no GitHub