Bản gốc tiếng Anh: https://argusic.com/subject/headroom

headroom

Nén đầu ra công cụ, nhật ký, tệp và các khối RAG trước khi chúng đến LLM. Giảm 20% số token cho coding agents, giảm 60-95% số token cho JSON, cùng câu trả lời. Thư viện, proxy, máy chủ MCP.

Chạy đượcnguồn: GitHubtrang chủ dự ánPythonApache-2.0commit 5d025f7a0387

Python, giấy phép Apache-2.0. Dự án tự gắn nhãn: agent, ai, anthropic, claude code, compression, context engineering, context window và cursor.

headroom chạy được. Trên một máy sạch không có GPU, một agent của Argusic đã cài đặt nó trong 31 phút, gặp 4 lỗi và tự sửa hết mà không cần trợ giúp, và toàn bộ phiên làm việc được ghi lại.

Rust workspace (headroom-core, headroom-proxy, headroom-parity, headroom-simulators) builds from source and all cargo tests pass.

Kết quả agent đạt được trên máy sạch, bằng chính lời của nó. Cách đo

Argusic đo trên một máy mới mỗi lần. Mỗi con số đều link tới bằng chứng của nó. Điểm Argusic 100 trên 100 (trung bình điểm các lần chạy của dự án này).

Tóm tắt

kết luận
Chạy được
Điểm Argusic
100 / 100
chi phí của lần chạy kiểm chứng
0,21 USD (đo thực tế)
số lần chạy đã ghi
1
test gần nhất
lượt star
78.831
fork
6.160
issue đang mở
398
người theo dõi
213
dung lượng
99 MB
ngày tạo
push gần nhất

Dữ liệu dự án lấy từ GitHub, có link ở đầu trang, cập nhật . Dữ liệu test của Argusic (CC BY 4.0); mỗi con số đều link tới một trang run có đầy đủ log, bản ghi và mã sha256 của chúng.

Những gì đã đo

Lấy từ lần chạy quyết định kết luận này. Mỗi dòng là một giá trị được ghi lại, không phải ước tính.

Thời gian mất cho từng lỗi khi test headroom, vẽ từ lần chạy được ghi lại
Mỗi cột là một lỗi agent đã ghi lại, kèm thời gian nó tốn. Vẽ từ lần chạy này, không lấy từ nguồn nào khác.

Những gì trục trặc, bằng chính lời của agent

Lời của chính agent, lỗi nặng nhất trước, không bao giờ viết lại thành lời khuyên.

  • No C compiler (gcc/cc) or binutils in container. Also no pip/venv for Python.15 phút
  • GCC fixed include headers (stdint.h) use #include_next which needs system headers in correct search order5 phút
  • C++ compiler needed by esaxx-rs crate (needs cc1plus)3 phút
  • libc.so linker script has hardcoded absolute paths (/usr/lib/x86_64-linux-gnu/libc_nonshared.a)3 phút
Thời gian cài đặt
31 phút
Từ máy sạch đến khi xong
32 phút
Lỗi gặp và đã sửa
gặp 4, tự sửa 4 mà không cần người giúp
Số token model đã dùng
501.722
Commit chính xác đã test
5d025f7a0387
Container image
sha256:4c3d41857be3

Những gì chưa đo

Nửa còn lại, để bạn thấy rõ bằng chứng này đi xa tới đâu. Chỗ trống được ghi là chỗ trống và không bao giờ được lấp vào.

Cách chứng minh kết quả
các lần chạy trước 2026-09-07 không ghi lại lệnh dùng để kiểm tra kết quả
Bộ nhớ GPU cao nhất
lần này chạy trên máy CPU, nên không có GPU để đo
Hoạt động khi chạy lâu
mỗi lần thử dùng cấu hình nhỏ nhất có trong tài liệu và một khoảng thời gian cố định, nên đây là đo xem nó có chạy hay không, không đo nó chịu tải ra sao

Đoạn cuối của bản ghi

Những dòng cuối của phiên terminal đã quyết định kết luận này, đúng như khi được ghi lại.

**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…

Xem lại toàn bộ phiên, mọi lệnh từ máy sạch tới thời điểm này.

Cách test

Một agent, một container, không có người giúp. Agent cài dự án theo đúng cách tài liệu của dự án hướng dẫn, chạy nó, và sửa những gì bị hỏng. Mọi thứ bên dưới được ghi lại đúng như đã diễn ra: phiên terminal, log và commit chính xác. Toàn bộ phương pháp.

Điểm mạnh và giới hạn

Dữ kiện đo được, không phải ý kiến. Cách viết nội dung.

Những gì suôn sẻ

  • Đạt trạng thái chạy được trên máy sạch, có ghi lại phiên làm việc.
  • Tự khắc phục cả 4 lỗi mà không cần người can thiệp, cho thấy các lỗi được ghi trong tài liệu đủ rõ để giải quyết.
  • Chạy được không cần GPU, nên không cần GPU để khởi động.
  • Giấy phép Apache-2.0, theo thông tin từ nơi lưu trữ dự án.

Những gì không suôn sẻ, hoặc chưa biết

  • Mất 31 phút để cài đặt, chậm hơn trung vị của 134 dự án tương đương mà Argusic đã đo.
  • Mới đo một lần. Một lần thử cho thấy nó có thể chạy, chưa cho thấy nó chạy ổn định.

Trong 135 dự án agent mà Argusic đã cài đặt và bấm giờ, headroom đứng thứ 124 về tốc độ đạt trạng thái chạy được, và 87 trên 135 dự án đạt được trạng thái đó.

Phù hợp để dùng cho

  • Thử trên laptop hoặc máy chủ nhỏ: nó đạt trạng thái chạy được mà không cần GPU.

Cũng đã test, cùng lĩnh vực

Mỗi dự án ở đây đều được Argusic cài đặt và chạy trên máy sạch. Không có dự án nào chưa test xuất hiện ở đây.

Lịch sử chạy

test bởilần thửkết quảđiểmchi phí USDthời điểm
Argusic Runner1/3Chạy được100,000,21

Chủ đề (từ GitHub)

agentaianthropicclaude-codecompressioncontext-engineeringcontext-windowcursorfastapilangchainllmmcpopenaiprompt-engineeringproxypythonragtoken-optimizationtokenstypescript

Nhúng badge

Markdown cho README của dự án. Badge link về trang này; điều khoản ở trang điều khoản.

[![Tested by Argusic](https://argusic.com/badge/headroom.svg)](https://argusic.com/subject/headroom)

Câu hỏi

headroom có chạy được không?
Có. headroom chạy được. Argusic đã cài đặt và khởi chạy nó trên một máy sạch trong 31 phút, gặp 4 lỗi trên đường đi, và ghi lại phiên làm việc.
Argusic đã test headroom như thế nào?
Trên một máy mới, dùng một lần, mọi lệnh đều được ghi lại và repo được ghim ở commit 5d025f7a0387. Có một lần thử được ghi lại, và toàn bộ phương pháp nằm ở trang phương pháp.
Test headroom tốn bao nhiêu?
Lần chạy đưa ra kết luận này tốn 0,21 USD: chi phí máy và model thật, không phải giá niêm yết theo triệu token. Con số được ghi trên trang của lần chạy đó.
Cài đặt headroom mất bao lâu?
31 phút trong lần chạy quyết định kết luận này, từ máy sạch đến trạng thái chạy được. Đó là một lần thử đo được, không phải số trung bình.
headroom có cần GPU không?
Không cần để khởi động. Argusic đã đạt trạng thái chạy được trên một máy không có GPU.
Cài đặt headroom thì gặp lỗi gì?
4 lỗi xảy ra trong lần chạy được ghi lại, và 4 lỗi đã được sửa mà không cần người giúp. Từng lỗi, cùng thời gian nó tốn, được liệt kê trên trang này.
headroom so với các lựa chọn khác thế nào?
Trong 135 dự án agent mà Argusic đã cài đặt và bấm giờ, headroom đứng thứ 124 về tốc độ đạt trạng thái chạy được, và 87 trên 135 dự án đạt được trạng thái đó.
Bằng chứng cho headroom ở đâu?
Lần chạy được ghi lại nằm trên trang này, mỗi lần link tới log đầy đủ và terminal recording, được lưu kèm dấu vân tay sha256 để không thể bị sửa lén.

Discussion