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

verdict
Fonctionne
Score Argusic
100 / 100
coût de l'exécution de vérification
0,21 USD (mesuré)
exécutions enregistrées
1
dernier test
étoiles
78 831
forks
6 160
issues ouvertes
398
observateurs
213
taille
99 MB
créé le
dernier push

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.

Temps perdu à cause de chaque échec lors du test d'headroom, tiré de l'exécution enregistrée
Chaque barre est un échec enregistré par l'agent, avec le temps qu'il a coûté. Tiré de cette exécution, et de nulle part ailleurs.

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é partentativerésultatscorecoût USDdate
Argusic Runner1/3Fonctionne100,000,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.

[![Tested by Argusic](https://argusic.com/badge/headroom.svg)](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.

Discussion