Original en anglais: https://argusic.com/subject/headroom
headroom
Compressez les sorties d'outils, les logs, les fichiers et les morceaux RAG avant qu'ils n'atteignent le LLM. 20 % de tokens en moins pour les agents de codage, 60-95 % de tokens en moins pour le JSON, mêmes réponses. Bibliothèque, proxy, serveur MCP.
Fonctionnesource : GitHubpage d'accueilPythonApache-2.0commit 5d025f7a0387
Python, sous licence Apache-2.0. Le projet se décrit ainsi : agent, ai, anthropic, claude code, compression, context engineering, context window et cursor.
headroom fonctionne. Un agent Argusic l'a installé en 31 minutes et a rencontré 4 erreurs, toutes corrigées sans aide sur une machine propre sans GPU, et toute la session a été enregistrée.
Rust workspace (headroom-core, headroom-proxy, headroom-parity, headroom-simulators) builds from source and all cargo tests pass.
Ce que l'agent a obtenu sur une machine propre, dans ses propres mots. Comment c'est mesuré
Mesuré par Argusic sur une machine vierge, à chaque fois. Chaque chiffre renvoie à ses preuves. Score Argusic de 100 sur 100 (la moyenne des scores des exécutions de ce projet).
En un coup d'œil
Données du projet issues de GitHub, avec un lien en haut de cette page, mis à jour le . Données de test d'Argusic (CC BY 4.0) ; chaque chiffre renvoie à une page d'exécution avec le log complet, l'enregistrement et leurs empreintes sha256.
Ce qui a été mesuré
Tiré de l'exécution qui a décidé ce verdict. Chaque ligne est une valeur enregistrée, pas une estimation.

Ce qui s'est mal passé, dans les mots de l'agent
Les propres mots de l'agent, le plus grave en premier, jamais réécrits en conseils.
- No C compiler (gcc/cc) or binutils in container. Also no pip/venv for Python.15 minutes
- GCC fixed include headers (stdint.h) use #include_next which needs system headers in correct search order5 minutes
- C++ compiler needed by esaxx-rs crate (needs cc1plus)3 minutes
- libc.so linker script has hardcoded absolute paths (/usr/lib/x86_64-linux-gnu/libc_nonshared.a)3 minutes
- Temps d'installation
- 31 minutes
- De la machine vierge à la fin
- 32 minutes
- Erreurs rencontrées et corrigées
- 4 rencontrées, 4 corrigées sans aide humaine
- Tokens de modèle utilisés
- 501 722
- Commit exact testé
- 5d025f7a0387
- Image de conteneur
- sha256:4c3d41857be3
Ce qui n'a pas été mesuré
L'autre moitié, pour que vous voyiez exactement jusqu'où vont ces preuves. Une lacune est affichée comme une lacune et n'est jamais comblée.
- Comment le résultat a été prouvé
- les exécutions antérieures au 2026-09-07 n'enregistraient pas la commande utilisée pour vérifier le résultat
- Pic de mémoire GPU
- cette exécution a eu lieu sur une machine CPU, il n'y avait donc pas de GPU à mesurer
- Comportement sur une longue durée
- chaque tentative utilise les réglages documentés les plus légers et un budget de temps fixe : on mesure donc s'il fonctionne, pas comment il tient sous la charge
La fin de l'enregistrement
Les dernières lignes de la session de terminal qui a décidé ce verdict, exactement telles qu'elles ont été enregistrées.
**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…
Revoir toute la session, chaque commande depuis une machine propre jusqu'à ce point.
Comment le test a été mené
Un agent, un conteneur, aucune aide humaine. Il installe le projet comme l'indique sa propre documentation, l'exécute et corrige ce qui casse. Tout ce qui suit est enregistré tel que cela s'est passé : la session de terminal, le log et le commit exact. La méthode complète.
Points forts et limites
Des faits mesurés, pas des opinions. Comment ce site est rédigé.
Ce qui s'est bien passé
- A atteint un état de fonctionnement sur une machine propre, avec la session enregistrée.
- S'est remis des 4 erreurs sans intervention humaine, ce qui indique que les échecs sont assez bien documentés pour être résolus.
- A fonctionné sans GPU, il n'en a donc pas besoin pour démarrer.
- Sous licence Apache-2.0, selon son hébergeur.
Ce qui ne s'est pas bien passé, ou n'est pas connu
- Installation en 31 minutes, plus lente que la médiane des 134 projets comparables mesurés par Argusic.
- Mesuré une seule fois jusqu'ici. Une seule tentative montre qu'il peut fonctionner, pas qu'il fonctionne de façon fiable.
Sur les 135 projets agent qu'Argusic a installés et chronométrés, headroom a été le 124e plus rapide à atteindre un état de fonctionnement, et 87 sur 135 en ont atteint un.
Pour quoi c'est un choix raisonnable
- L'essayer sur un ordinateur portable ou un petit serveur : il a atteint un état de fonctionnement sans GPU.
Également testés, dans le même domaine
Chacun de ces projets a été installé et exécuté par Argusic sur une machine propre. Rien n'apparaît ici sans avoir été testé.
Historique des exécutions
| testé par | tentative | résultat | score | coût USD | date |
|---|---|---|---|---|---|
| Argusic Runner | 1/3 | Fonctionne | 100,00 | 0,21 |
Sujets (depuis GitHub)
agentaianthropicclaude-codecompressioncontext-engineeringcontext-windowcursorfastapilangchainllmmcpopenaiprompt-engineeringproxypythonragtoken-optimizationtokenstypescript
Intégrer le badge
Markdown pour le README du projet. Il renvoie vers cette page ; conditions sur la page des conditions.
[](https://argusic.com/subject/headroom)Questions
- headroom fonctionne-t-il ?
- Oui. headroom fonctionne. Argusic l'a installé et lancé sur une machine propre en 31 minutes, en rencontrant 4 erreurs en route, et a enregistré la session.
- Comment Argusic a-t-il testé headroom ?
- Sur une machine vierge et jetable, avec chaque commande enregistrée et le dépôt épinglé au commit 5d025f7a0387. Une tentative est enregistrée, et la méthode complète se trouve sur la page de méthodologie.
- Combien a coûté le test d'headroom ?
- L'exécution qui a produit ce verdict a coûté 0,21 USD : le coût réel du calcul et du modèle, pas un prix catalogue par million de tokens. Il est enregistré sur la page de cette exécution.
- Combien de temps faut-il pour installer headroom ?
- 31 minutes lors de l'exécution qui a décidé ce verdict, d'une machine propre à un état de fonctionnement. Il s'agit d'une tentative mesurée, pas d'une moyenne.
- headroom a-t-il besoin d'un GPU ?
- Pas pour démarrer. Argusic a atteint un état de fonctionnement sur une machine sans GPU.
- Qu'est-ce qui pose problème lors de l'installation d'headroom ?
- 4 problèmes sont survenus lors de l'exécution enregistrée, et 4 ont été corrigés sans aide humaine. Chacun, avec le temps qu'il a coûté, est listé sur cette page.
- Comment headroom se compare-t-il aux alternatives ?
- Sur les 135 projets agent qu'Argusic a installés et chronométrés, headroom a été le 124e plus rapide à atteindre un état de fonctionnement, et 87 sur 135 en ont atteint un.
- Où sont les preuves pour headroom ?
- L'exécution enregistrée se trouve sur cette page, chacune avec un lien vers son log complet et son enregistrement du terminal, conservés avec une empreinte sha256 pour qu'ils ne puissent pas être modifiés discrètement.