headroomlabs-ai/headroom

Health v2 · maintenance only

Adoption not part of the score

67706 stars · 5227 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

Headroom is a context compression layer for LLM applications that compresses tool outputs, logs, files, RAG chunks, and images before they reach the model, claiming 60-95% token savings on JSON and 15-20% on coding agent traffic. It ships as a Python/TypeScript library, a local proxy server, and an MCP server, with content-aware compressors including statistical JSON pruning, AST-aware code compression, and ML-routed image compression.

Use cases

• reduce LLM token costs for AI coding agents like Claude Code or Cursor
• compress large JSON tool outputs before sending to GPT-4o or Claude
• shrink RAG retrieval chunks to fit more context in the window
• compress images sent to vision models to cut token spend
• run a local proxy that transparently compresses OpenAI/Anthropic API traffic
• add token compression middleware to LangChain or Vercel AI SDK apps
• compress log files and command outputs fed to agents

When to choose

• you spend heavily on LLM tokens from verbose tool outputs, JSON arrays, or RAG chunks
• you want drop-in compression via SDK wrappers, a proxy, or MCP without changing prompts
• you need reversible compression so original content can be recovered
• you use coding agents and want fewer tokens without degrading answer quality

When to avoid

• your prompts are already small and token cost is not a concern
• you cannot tolerate any risk of compression altering model answers
• you need Windows or Intel macOS first-class support without building Rust extensions
• you require a fully managed cloud service rather than a local-first tool

Facets

library · maturity active

compression rag prompt-engineering mcp proxy middleware sdk developer-tools large-language-models developer-tools artificial-intelligence python cli cross-platform token-optimization context-window context-compression llm-cost-reduction coding-agents claude-code cursor langchain openai anthropic reversible-compression ast-compression tree-sitter smartcrusher image-token-compression ai-agents retrieval-augmented-generation nodejs docker macos linux

Member repositories

For agents

markdown · JSON · MCP: product_card(name="headroomlabs-ai/headroom")