OpenSource-Hub
H

headroom

SHA-256
7.4k stars·AI 生産性·SHA-256 チェックサム確認済み

AIエージェントが読み取る前にツール出力、ログ、RAGチャンク、ファイルを圧縮し、トークンを60〜95%削減しつつ回答はそのまま維持。ライブラリ、エージェント、MCPサーバーを提供。

スマートダウンロード

Download 版をダウンロード

v0.22.4 · 15.3 MB

AIエージェントのトークンを節約する神ツール、圧縮率は驚異的で、答えは変わらない。

主な機能

  • 逆圧縮（CCR）：元データをローカル保存し、LLMが必要に応じて検索可能、劣化なし
  • 6種類の圧縮アルゴリズムを自動適用：JSONスマート圧縮、ASTコード圧縮、テキスト圧縮など
  • コードゼロ統合：プロキシモード（Claude Code/Codex/Cursorなど一行コマンド）、ライブラリ呼び出し、透過プロキシに対応
  • クロスエージェントメモリ：Claude、Codex、Geminiなどが圧縮コンテキストを共有し、自動重複排除
  • 自動学習：失敗セッションを分析し、修正内容をAGENTS.md/CLAUDE.mdに記述

できないこと

  • •Python 3.10+ および最新の Node.js 環境のみをサポートします。AI エージェントのシナリオに適しており、プレーンテキスト圧縮の効果は一般的です。可逆圧縮（CCR）にはローカルストレージ容量が必要です。完全にクラウドに依存しておりファイルを保持できない場合は、CCR を無効にしてください。

使用例

  • AIプログラミングエージェントの日常使用（Claude Code、Cursor、Aiderなど）により、API費用を大幅に削減
  • マルチエージェント協調ワークフローにより、共有メモリを通じて重複するコンテキスト転送を削減

Headroomは、AIエージェント向けのコンテキスト圧縮レイヤーであり、トークン使用量を60〜95%削減しつつ、回答精度を維持します。LLMが読み取る前に、ツール出力、ログ、RAG断片、ファイル、会話履歴を圧縮します。LLMLinguaやSelective Contextなどのツールと比較して、Headroomは可逆圧縮（CCR）を提供し、元のコンテンツは決して失われません。また、クロスエージェントメモリ（Claude、Codex、Cursor、Aiderなど）をサポートします。完全にローカルで動作し、6種類の圧縮アルゴリズム（SmartCrusher、CodeCompressor、Kompress-baseなど）を内蔵しており、ライブラリ呼び出し、エージェント、MCPサーバー、またはエージェントラッパーを介して統合できます。

タグ

AI代理上下文压缩Token节省LLMMCPClaude CodeCodexCursor可逆压缩跨代理记忆

はじめ方

1

インストーラをダウンロード

上のボタンをクリックして、お使いのシステム用のインストーラをダウンロード

macOS· 15.3 MBLinux· 17.3 MBWindows· 16.5 MB
2

ソフトウェアをインストール

ダウンロードした dmg ファイルを開き、アプリを Applications にドラッグ

3

依存関係のインストール：pip install "headroom-ai[all]" または npm install headroom-ai

4

統合方法の選択：headroom wrap claude を実行してラッパープロキシを構成するか、headroom proxy --port 8787 を実行して透過プロキシを起動

5

効果の検証：headroom stats を実行してトークン圧縮の統計を確認

インストールガイド
  1. 依存関係のインストール：pip install "headroom-ai[all]" または npm install headroom-ai
  2. 統合方法の選択：headroom wrap claude を実行してラッパープロキシを構成するか、headroom proxy --port 8787 を実行して透過プロキシを起動
  3. 効果の検証：headroom stats を実行してトークン圧縮の統計を確認
ファイルの整合性

SHA-256 チェックサム確認済み

GitHub 公式 Release ページから抽出されたチェックサム

SHA256 チェックサム

0942c5d45c6f94bb2cc7b094a323175bae262fdc3d38ab088e27aea6cc5186f3

このチェックサムは GitHub Release ページから抽出されたものです。ダウンロード後にファイルの整合性を確認してください。

本プラットフォーム上のすべての SHA-256 チェックサムは、プロジェクトの公式 GitHub Release ページから抽出されたもので、一切の改変はありません。GitHub Releases ページで独自に検証できます。

オープンソースの透明性

GitHub ソースを見る
環境ガイド

アンインストール情報

パッケージを直接アンインストール：pip uninstall headroom-ai または npm uninstall headroom-ai；wrapを使って設定ファイルを作成した場合は、手動で ~/.headroom ディレクトリ及びプロキシがカスタマイズした環境変数を削除してください。

追加の依存関係なし

ダウンロード後すぐに使用可能。追加のランタイムは不要です。

プロジェクト情報
ライセンスApache-2.0
最終更新2026-06-26 11:15:05
GitHub リポジトリ公式サイト

問題が発生？以下のFAQを確認

5 FAQs

類似プロジェクト

L

LocalAI

本地运行 AI 模型的开源引擎，无需 GPU，兼容 OpenAI API，支持多种硬件和模型类型。

G

goose

一个开源的通用 AI 代理，提供桌面应用、命令行和 API，支持 15+ 厂商模型和 70+ 扩展。

D

daily_stock_analysis

AI大モデルを基盤としたA株/香港株/米株のスマート分析システムにより、意思決定ダッシュボードを自動生成し、マルチチャネルでプッシュ配信。ゼロコストで定期実行が可能。