AIエージェント向けのコンテキスト圧縮レイヤー。JSON・コード・テキストを60~95%削減し、同じ精度を保ちます。
中辛 の解説
Python・TypeScript対応のライブラリ。FastAPI プロキシ、、MCPサーバーで提供されます。SmartCrusher(JSON)・CodeCompressor(AST)・Kompress-v2-base(テキスト)の3つのエンジンがコンテンツ種別を自動判定して最適に圧縮します。難易度は中程度で、実験的なML機能([ml]・[vector]など)は別途インストール可能です。ベンチマークでは、標準テスト(GSM8K・SQuAD・BFCL)で精度を保ったまま32~97%のトークン削減を達成しています。
이런 레포예요
이럴 때 쓰면 좋아요
- 大規模コードベースの探索時にコンテキストウィンドウを節約し、エージェントの推論回数を増やす
- GitHub Issue トライアージやSRE インシデント対応で、ログ・検索結果を圧縮してLLM呼び出し費用を削減する
- Claude Code・Cursor・Aider などの複数エージェントで同じ学習履歴を共有し、効率を高める
핵심 기능
대안 대비 차별점
Prompt Caching や RAG 最適化と異なり、圧縮後も原文が完全に復元でき、13種以上のエージェント・LLMプロバイダ(Anthropic・OpenAI・Bedrock など)に統一インターフェースで適用できます。
食べた人たち
実際に使ってみた人の記録です — 一言も完走の記録も、確認のうえで公開しています。
このリポジトリの作り方
はじめてですか? むずかしくありません — 上から順にたどれば、自分の環境で動かして味見できます。
준비물
- Python 3.10以上
- x86/x86_64環境の場合 AVX2対応CPU(ONNX Runtime が必要)
すぐ動かしてみるPython (uv)
ギット飯がリポジトリの構成を確認して組み立てた実行コマンドです。ターミナルに貼り付ければ、取得から実行までまとめて進みます。
git clone --depth 1 https://github.com/headroomlabs-ai/headroom.git && cd headroom && uv sync
uv가 없다면: brew install uv · 실행 명령은 README를 확인하세요.
コードは自分の環境で動きます — はじめて見るリポジトリなら、中身にひととおり目を通してから実行するのがおすすめです。
README가 안내하는 자세한 단계 보기
- インストール
uv tool install --python 3.13 "headroom-ai[all]"
- セットアップを確認
headroom doctor
- プロキシ起動(ポート 8787 で)
headroom proxy --port 8787
- またはエージェントをラップ(例:Claude Code)
headroom wrap claude
- 圧縮効果を確認
headroom dashboard
ギット飯トライで味見
入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。
ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。
npx gitbap-try headroomlabs-ai/headroom
Node.js さえあれば、インストールなしで動きます · ギット飯トライとは? →
これを仕事に活かす
味見がすんだら次は応用です — 仕事やビジネスに活かす方法をまとめました。
レシピ — AI にこのまま頼んでみてください
レシピを読み込んでいます…
スター推移 · 7日
使いやすさ · まねしやすいか
- ゆるいライセンス
- テストあり
- サンプル集
- 最近の更新
- AGENTS.md
- llms.txt
- テンプレート
最近の更新あり · 2026 年に作成
「LLM 도구·RAG」 こういうリポジトリを毎週受け取りませんか?
毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。
自分のリポジトリですか? README にギット飯バッジを貼る
[](https://www.gitbap.com/r/headroomlabs-ai/headroom)Claude からそのまま使う — ギット飯のつなぎ方
ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。
Claude の設定 → コネクタにこのアドレスを貼り付け。
https://www.gitbap.com/api/mcpプラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI が README をもとに要約しました · 原文を見る