headroomlabs-ai/headroom

AIエージェント向けのコンテキスト圧縮レイヤー。JSON・コード・テキストを60~95%削減し、同じ精度を保ちます。

開発の材料自由に使える · Apache-2.0LLM ツール・RAGPython難易度
67,395+749今週0
5,193フォーク252Issue
デモ・公式サイトをひらくdocs.headroomlabs.ai

中辛 の解説

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 などの複数エージェントで同じ学習履歴を共有し、効率を高める

핵심 기능

ContentRouter による自動コンテンツ分類と3種類のコンプレッサー(JSON・AST・テキスト)60~95%のトークン削減と精度維持(GSM8K・SQuAD・BFCL ベンチマーク対応)可逆圧縮(CCR)で原文をキャッシュし、必要時に復元可能

대안 대비 차별점

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가 안내하는 자세한 단계 보기
  1. インストール
uv tool install --python 3.13 "headroom-ai[all]"
  1. セットアップを確認
headroom doctor
  1. プロキシ起動(ポート 8787 で)
headroom proxy --port 8787
  1. またはエージェントをラップ(例:Claude Code)
headroom wrap claude
  1. 圧縮効果を確認
headroom dashboard

ギット飯トライで味見

入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。

ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。

npx gitbap-try headroomlabs-ai/headroom

Node.js さえあれば、インストールなしで動きます · ギット飯トライとは? →

これを仕事に活かす

味見がすんだら次は応用です — 仕事やビジネスに活かす方法をまとめました。

レシピ — AI にこのまま頼んでみてください

レシピを読み込んでいます…

スター推移 · 7日

67,395+749 / 7일

使いやすさ · まねしやすいか

ベストサンプルサンプル評点 80/100
  • ゆるいライセンス
  • テストあり
  • サンプル集
  • 最近の更新
  • AGENTS.md
  • llms.txt
  • テンプレート

最近の更新あり · 2026 年に作成

「LLM 도구·RAG」 こういうリポジトリを毎週受け取りませんか?

毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。

自分のリポジトリですか? README にギット飯バッジを貼る
[![깃밥](https://www.gitbap.com/badge/headroomlabs-ai/headroom.svg)](https://www.gitbap.com/r/headroomlabs-ai/headroom)
Claude からそのまま使う — ギット飯のつなぎ方

ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。

方法 ① コネクタ URL

Claude の設定 → コネクタにこのアドレスを貼り付け。

https://www.gitbap.com/api/mcp
方法 ② プラグイン(試用まで)

プラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
つなぎ方をくわしく →

AI が README をもとに要約しました · 原文を見る