방방구석컴퍼니
← 오픈소스 도구함
개발·배포직접 써봄

Headroom

로그·도구 출력·검색 문서를 LLM에 보내기 전에 압축하는 도구

상세 설명

프록시, 라이브러리, MCP 방식으로 긴 입력을 줄이는 도구입니다. 108회 비교 실험에 포함했고, 입력 토큰 감소와 실제 요금 감소를 따로 측정했습니다. 어떤 항목을 압축하는지와 캐시 사용 방식에 따라 결과가 달라집니다.

장점

  • 긴 로그와 구조화 데이터의 입력량을 줄이는 데 활용할 수 있습니다.
  • 기존 에이전트를 감싸는 실행 방식과 개발용 라이브러리를 제공합니다.

단점·확인할 점

  • 압축률만으로 전체 요금 절감률을 예상하기 어렵습니다.
  • 프록시를 연결할 때 모델 제공자 주소와 인증 설정을 맞춰야 합니다.

INSTALL

설치 방법

  1. 01

    별도 Python 환경에서 공식 설치 안내에 따라 headroom-ai 패키지를 설치합니다.

  2. 02

    headroom --version 으로 확인하고 사용할 모델 제공자 설정을 점검합니다.

  3. 03

    클로드 코드는 headroom wrap claude 로 실행한 뒤 짧은 작업의 결과와 사용량을 비교합니다.

설치 방법은 운영체제와 버전에 따라 달라질 수 있으니 공식 문서를 함께 확인하세요.

공식 자료

최신 정보는 공식 문서에서 확인하세요.