headroomlabs-ai/headroom
AI 에이전트의 컨텍스트를 60~95% 압축해 토큰 비용을 대폭 절감하는 로컬 우선 압축 레이어
54,518+4,873이번 주0 찜
3,916포크234이슈
중간맛 분석
Python/TypeScript 라이브러리, OpenAI 호환 프록시, MCP 서버 세 가지 방식을 모두 지원합니다. Claude Code·Cursor·Aider·Codex 등 주요 코딩 에이전트에 headroom wrap <tool> 한 줄로 붙일 수 있고, 실제 워크로드에서 47~92% 토큰 절감이 측정됐습니다. Python 3.10+ 필요, pip install headroom-ai[all]로 즉시 설치 가능하며 대시보드로 실시간 절감량을 확인할 수 있습니다.
이런 레포예요
이럴 때 쓰면 좋아요
- AI 코딩 에이전트(Claude Code, Cursor 등)를 매일 사용하면서 토큰 비용을 줄이고 싶을 때
- 여러 AI 에이전트 간에 공유 메모리와 컨텍스트를 유지하고 싶을 때
- 기존 코드 변경 없이 OpenAI 호환 앱의 토큰 사용량을 줄이고 싶을 때
핵심 기능
콘텐츠 타입 인식 자동 라우팅(JSON·코드·텍스트별 전용 압축기)가역 압축(CCR)으로 원본 데이터 로컬 보존 및 복원 지원에이전트 래핑·프록시·라이브러리·MCP 네 가지 통합 방식 지원
대안 대비 차별점
단순 요약이 아닌 콘텐츠 타입별 전용 압축기(SmartCrusher·CodeCompressor·Kompress-v2-base)와 가역 압축(CCR)을 결합해, 코드 변경 없이 60~95% 토큰 절감과 원본 복원을 동시에 제공하는 점이 유사 도구와 다릅니다.
준비물
- Python 3.10 이상
- Node.js (TypeScript/Node 사용 시)
- C++ 빌드 툴체인 (벡터 HNSW 백엔드 사용 시 선택 사항)
바로 시작하기
- Python 패키지 설치
pip install "headroom-ai[all]"
- (선택) Node/TypeScript 설치
npm install headroom-ai
- 에이전트 래핑 또는 프록시 실행 중 하나를 선택
headroom wrap claude
# 또는
headroom proxy --port 8787
- 설정 확인 및 절감량 확인
headroom doctor
headroom perf
headroom dashboard
별 추이 · 7일
54,518+4,873 / 7일
활용성 · 따라 만들기 좋은가
베스트 샘플샘플 점수 80/100
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2026년 생성
이 레포에 깃밥 배지 달기
[](https://www.gitbap.com/r/headroomlabs-ai/headroom)🔌 클로드에서 바로 써보기
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
방법 ① 커넥터 URL
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp방법 ② 플러그인 (체험까지)
플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기