Original en inglés: https://argusic.com/subject/headroom
headroom
Comprime las salidas de herramientas, logs, archivos y fragmentos RAG antes de que lleguen al LLM. 20% menos tokens para coding agents, 60-95% menos tokens para JSON, mismas respuestas. Biblioteca, proxy, servidor MCP.
Funcionafuente: GitHubsitio webPythonApache-2.0commit 5d025f7a0387
Python, licencia Apache-2.0. El proyecto se describe a sí mismo como: agent, ai, anthropic, claude code, compression, context engineering, context window y cursor.
headroom funciona. Un agent de Argusic lo instaló en 31 minutos y encontró 4 errores, todos corregidos sin ayuda en una máquina limpia sin GPU, y toda la sesión quedó grabada.
Rust workspace (headroom-core, headroom-proxy, headroom-parity, headroom-simulators) builds from source and all cargo tests pass.
Lo que el agent consiguió en una máquina limpia, en sus propias palabras. Cómo se mide
Medido por Argusic en una máquina limpia cada vez. Cada cifra enlaza a su evidencia. Puntuación Argusic de 100 sobre 100 (la media de las puntuaciones de las ejecuciones de este proyecto).
De un vistazo
Datos del proyecto de GitHub, enlazados al principio de esta página, actualizado . Datos de prueba de Argusic (CC BY 4.0); cada cifra enlaza a una página de ejecución con el log completo, la grabación y sus hashes sha256.
Qué se midió
De la ejecución que decidió este veredicto. Cada línea es un valor registrado, no una estimación.
Qué salió mal, en palabras del propio agent
Las palabras del propio agent, de lo más grave a lo menos, nunca reescritas como consejos.
- No C compiler (gcc/cc) or binutils in container. Also no pip/venv for Python.15 minutos
- GCC fixed include headers (stdint.h) use #include_next which needs system headers in correct search order5 minutos
- C++ compiler needed by esaxx-rs crate (needs cc1plus)3 minutos
- libc.so linker script has hardcoded absolute paths (/usr/lib/x86_64-linux-gnu/libc_nonshared.a)3 minutos
- Tiempo de instalación
- 31 minutos
- De máquina en frío a terminar
- 32 minutos
- Errores encontrados y corregidos
- 4 encontrados, 4 corregidos sin ayuda humana
- Tokens de modelo usados
- 501.722
- Commit exacto probado
- 5d025f7a0387
- Imagen del contenedor
- sha256:4c3d41857be3
Qué no se midió
La otra mitad, para que veas exactamente hasta dónde llega esta evidencia. Un hueco se muestra como hueco y nunca se rellena.
- Cómo se demostró el resultado
- las ejecuciones anteriores al 2026-09-07 no registraban el comando usado para comprobar el resultado
- Memoria de GPU máxima
- se ejecutó en una máquina con CPU, así que no había GPU que muestrear
- Comportamiento en una ejecución larga
- cada intento usa la configuración documentada más pequeña y un presupuesto de tiempo fijo, así que esto mide si funciona, no cómo aguanta bajo carga
El final de la grabación
Las últimas líneas de la sesión de terminal que decidió este veredicto, tal como se registraron.
**Result:** `cargo check --workspace` builds and `cargo test --workspace` passes all 925+ tests acr… tokens used 501,722 ## Summary **Headroom** (context compression layer for AI agents) installed and tested successfully. **Blockers found and fixed:** 1. **Missing C/C++ toolchain** — Container had no `gcc`, `g++`, `binutils`, or system headers. Down… 2. **Hardcoded absolute paths in libc.so linker script** — The extracted `libc.so` referenced `/usr… 3. **Missing system headers for `#include_next`** — GCC's fixed `stdint.h` and C++ headers use `#in… 4. **Missing C++ compiler for `esaxx-rs` crate** — Downloaded and installed `g++-14-x86-64-linux-gn… 5. **Python unavailable** — No `pip`/`venv` in container, so the Python side and PyO3 `headroom-py`… **Result:** `cargo check --workspace` builds and `cargo test --workspace` passes all 925+ tests acr…
Reproducir la sesión completa, cada comando desde una máquina limpia hasta este punto.
Cómo se probó
Un agent, un contenedor, sin ayuda humana. Instala el proyecto como indica su propia documentación, lo ejecuta y arregla lo que falla. Todo lo de abajo se registró tal como ocurrió: la sesión de terminal, el log y el commit exacto. La metodología completa.
Puntos fuertes y límites
Hechos medidos, no opiniones. Cómo se redacta.
Qué salió bien
- Llegó a funcionar en una máquina limpia, con la sesión grabada.
- Se recuperó de los 4 errores sin que interviniera una persona, lo que indica que los fallos están lo bastante documentados como para resolverlos.
- Funcionó sin GPU, así que no necesita una para arrancar.
- Licencia Apache-2.0, según su plataforma de origen.
Qué no salió bien, o no se sabe
- Tardó 31 minutos en instalarse, más lento que la mediana de los 134 proyectos comparables que ha medido Argusic.
- Medido una sola vez hasta ahora. Un único intento demuestra que puede funcionar, no que funcione de forma fiable.
De los 135 proyectos de agent que Argusic ha instalado y cronometrado, headroom fue el 124.º más rápido en llegar a funcionar, y 87 de 135 llegaron a funcionar.
Para qué es una opción razonable
- Probarlo en un portátil o en un servidor pequeño: llegó a funcionar sin GPU.
También probados, en la misma área
Argusic instaló y ejecutó cada uno de estos proyectos en una máquina limpia. Aquí no aparece nada que no se haya probado.
Historial de ejecuciones
Temas (de GitHub)
agentaianthropicclaude-codecompressioncontext-engineeringcontext-windowcursorfastapilangchainllmmcpopenaiprompt-engineeringproxypythonragtoken-optimizationtokenstypescript
Insertar el badge
Markdown para el README del proyecto. Enlaza de vuelta aquí; condiciones en la página de términos.
[](https://argusic.com/subject/headroom)Preguntas
- ¿Funciona headroom?
- Sí. headroom funciona. Argusic lo instaló y lo inició en una máquina limpia en 31 minutos, con 4 errores por el camino, y grabó la sesión.
- ¿Cómo probó Argusic headroom?
- En una máquina limpia y desechable, con cada comando grabado y el repositorio fijado en el commit 5d025f7a0387. Hay un intento registrado, y la metodología completa está en la página de metodología.
- ¿Cuánto costó probar headroom?
- La ejecución que produjo este veredicto costó 0,21 USD: costo real de cómputo y de modelo, no un precio de lista por millón de tokens. Consta en la página de esa ejecución.
- ¿Cuánto tarda headroom en instalarse?
- 31 minutos en la ejecución que decidió este veredicto, desde una máquina limpia hasta que funcionó. Es un intento medido, no una media.
- ¿Necesita headroom una GPU?
- No para arrancar. Argusic consiguió que funcionara en una máquina sin GPU.
- ¿Qué falla al instalar headroom?
- En la ejecución registrada fallaron 4 cosas, y 4 se corrigieron sin ayuda humana. Cada una, con el tiempo que costó, aparece en esta página.
- ¿Cómo se compara headroom con las alternativas?
- De los 135 proyectos de agent que Argusic ha instalado y cronometrado, headroom fue el 124.º más rápido en llegar a funcionar, y 87 de 135 llegaron a funcionar.
- ¿Dónde está la evidencia de headroom?
- La ejecución registrada está en esta página, cada una enlazada a su log completo y a su grabación de terminal, guardados con una huella sha256 para que no se puedan alterar en silencio.