RepoPicks Radar

Actualizado todos los días hacia las 23:30 UTC

Guías

Headroom

headroomlabs-ai/headroomRevisado por IA

Revisado por RepoPicks Radar el

¿Qué es Headroom?

Headroom se ubica entre tu agente de codificación con IA y el modelo, y comprime lo que pasa por el medio: salida de herramientas, registros, archivos, resultados de búsqueda e historial de chat. Puedes usarlo como librería de Python o TypeScript, como proxy local al que apunta tu agente, o como servidor MCP dentro de Claude Code, Codex, Cursor y otros. La compresión ocurre en tu propia máquina. Es una herramienta para desarrolladores: la instalas con pip o uv y ejecutas comandos. Las propias pruebas del repositorio muestran entre 21% y 57% menos tokens, según cuán repetitivo sea el texto.

Headroom es gratis y de código abierto (Apache-2.0) y puede reemplazar a Compresr y The Token Company.

¿Qué tan fácil es instalar Headroom?

C · instalar 1 o 2 herramientas · Windows

  • Windows C
  • macOS C
  • Linux C

En los tres sistemas necesitas Python 3.11 o más reciente y la terminal: `pip install "headroom-ai[all]"` (o `uv tool install`), y luego comandos como `headroom wrap claude` o `headroom proxy --port 8787`. Hay wheels listos para Windows, Linux y Apple Silicon, así que no hay que compilar nada; en Macs con Intel el README te manda a la instalación con Docker en su lugar, que es más difícil.

Headroom en GitHub

Estrellas
79.308el 10 nov 2026
Descargas
17.1931439 en la semana
Crecimiento
+557estrellas en 7 días

Estrellas a lo largo del tiempo

78.80079.00079.20079.400 4 nov6 nov8 nov10 nov 78.80079.00079.20079.400 4 nov7 nov10 nov

Datos

Funciona en
Windows, macOS, Linux
Necesitas instalar
Python
Para compilar desde el código
Python, Docker, Tarjeta gráfica, Rust
Espacio en disco
15 MB–45 MB · según el instalador
Cuentas o claves
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)
Costo
Gratis · Apache-2.0 y de uso gratuito. La misma empresa vende un "Headroom Enterprise" cerrado con más ahorro; de todos modos le pagas a tu propio proveedor de modelo por los tokens que queden.
Licencia
Apache-2.0 (Permisiva)
Puede reemplazar
Compresr, The Token Company
Último cambio en GitHub
10 nov 2026

Señales de riesgo de Headroom (9)

  • AtenciónEl comando de instalación ejecuta un script de internet

    El comando de instalación canaliza un script remoto hacia una shell: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

    revisión automática

  • AtenciónTelemetría activada por defecto

    "Telemetry" del README.md: "An anonymous beacon is on by default. It reports how compression behaved: ratios, counters, provider and model IDs, OS and architecture." Dice que los prompts y el código nunca se envían, y puedes desactivarlo con HEADROOM_BEACON=off, HEADROOM_TELEMETRY=off, DO_NOT_TRACK=1 o HEADROOM_OFFLINE=1.

    revisión con IA

  • AtenciónVe todos los prompts y tokens del proveedor

    Por diseño, cada solicitud al modelo pasa por este proxy local, y en el caso de Copilot también maneja credenciales: README.md, "headroom copilot-auth login stores a Headroom-specific Copilot OAuth token" y "The short-lived upstream Copilot token is held only in the proxy process." Cualquier cosa que pueda leer ese proceso puede leer tus prompts y tokens.

    revisión con IA

  • AtenciónPlano de datos abierto si se expone

    Encabezado de 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." El archivo que viene por defecto vincula todo a 127.0.0.1 para evitarlo.

    revisión con IA

  • AtenciónEdita la configuración de otras herramientas

    README.md: `headroom wrap` "installs Serena for semantic code navigation" como servidor MCP en `~/.claude.json`, "injects config" para OpenCode, Cline y Continue, escribe el selector de modelo de Claude Code con `--1m`, y `headroom learn` escribe correcciones en CLAUDE.local.md, CLAUDE.md, AGENTS.md, GEMINI.md o GROK.md. Hay un comando `unwrap` para deshacerlo.

    revisión con IA

  • InfoEl ahorro depende mucho del contenido

    La descripción del repositorio afirma "60-95% fewer tokens for JSON", mientras que los propios cuatro escenarios de referencia del README.md muestran 21%, 57%, 42% y 30%, y el texto agrega: "prose and already-dense output compress very little". La cifra de 31.7% de tokens de salida está marcada como "[estimated]" por la propia herramienta.

    revisión con IA

  • InfoLa versión gratuita es deliberadamente más débil

    "Headroom for teams" del 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."

    revisión con IA

  • InfoBeta con lanzamientos muy rápidos

    pyproject.toml lo marca como "Development Status :: 4 - Beta" en la versión 0.42.0, y GitHub muestra 175 lanzamientos para un repositorio creado el 2026-01-07, con 471 issues abiertos. Las cosas cambian semana a semana.

    revisión con IA

  • InfoInstalación o ejecución descarga modelos y binarios

    La sección "Corporate networks" del README.md lista dos servidores de descarga a los que se conecta por su cuenta: cdn.pyke.io para el ONNX Runtime que usa el núcleo en Rust, y huggingface.co para el modelo kompress-base. También señala que las funciones de ONNX necesitan un procesador con AVX2 en x86 y recurren a métodos más simples si no lo hay.

    revisión con IA

La evidencia aparece en su idioma original.

Lo que Radar no pudo verificar de Headroom

  • Si las respuestas realmente se mantienen iguales con tus propios prompts y herramientas
  • Qué envía en la práctica el beacon anónimo
  • El uso real de disco después de que los modelos, la caché local de texto original (CCR) y las bases de datos de memoria se llenen
  • Cuánto dinero ahorra realmente en tu factura, lo que depende de tu carga de trabajo
  • Si cada agente listado todavía funciona con la versión actual, dado el ritmo de lanzamientos

Proyectos parecidos

La app RepoPicks

Pronto: instala con 1 clic desde la app RepoPicks.

Antes de descargar

Ver la página de la versión en GitHub