headroom
Compress tool outputs, logs, files, and RAG chunks before they reach the LLM.
GraphCanon updated Sep 20, 2026 · GitHub synced Sep 20, 2026
103views this month
Decision brief
Headroom compresses data for LLMs, reducing token usage by 20% for coding agents and 60-95% for JSON, without altering answers. It offers a library, proxy, and MCP server.
Good fit when
- When you need to reduce token usage for coding agents by 20% and for JSON by 60-95% without changing the answers.
- If you are working with Python 3.10+ and require a tool that can compress tool outputs, logs, files, and RAG chunks before they reach the LLM.
Avoid when
- If you are working with environments that do not support Python 3.10+.
- When your project does not require token optimization or compression for JSON and coding agents.
- Requirements:
- Requires Docker; Requires Python 3.10+.; ONNX-backed features require AVX2 on x86/x86_64 hosts.
Observed Sep 18, 2026 · Source: enrich:decision_facts
Verify the decision
Maintenance and security
Full trust report- Maintenance
- Very active (0d since push)
- As of Sep 18, 2026
- Provenance
- Not a fork · Organization account
- As of Sep 18, 2026
- Security (OSV)
- No lockfile
- As of Sep 20, 2026
Public GitHub metadata and optional OSV scans. Signals, not a guarantee. Trust methodology.
Install
pip install headroomHow it fits your stack(24)
Typed graph edges - alternatives, integrations, successors, and dependencies. Ranked by relationship type, not raw GitHub stars.
Alternative
Integrates
Depends on
Related
Relationship graph
Optional deeper exploration of typed edges and category neighbours.
Similar tools
Same-category neighbours not already linked as typed edges.
Evidence and technical details
Sourced facts, taxonomy, compatibility claims, README excerpt, and machine-readable endpoints.
Overview
Headroom compresses data for LLMs, reducing token usage by 20% for coding agents and 60-95% for JSON, without altering answers. It offers a library, proxy, and MCP server.
Capability facts
- Deploy
- Self-host
Source: dockerfile:Dockerfile · Sep 18, 2026
- Docker
- Dockerfile present
Source: dockerfile:Dockerfile · Sep 18, 2026
- CLI
- CLI entrypoint
Source: pyproject.toml:[project.scripts] · Sep 18, 2026
- MCP server
- No MCP server detected
Source: repo_scan · Sep 18, 2026
- Languages
- python
Source: github.language+pyproject.toml · Sep 18, 2026
Categories
Graph entities
Compatibility
Sourced claims from the README excerpt - not unsourced marketing copy.
Source: README excerpt (regex_v1, Sep 18, 2026)
`[all]`), `[relevance]`, `[image]`, `[agno]`, `[langchain]`, `[evals]`,Source link
Source: README excerpt (regex_v1, Sep 18, 2026)
npm install headroom-ai # TypeScript SDK only — no CLISource link
Source: README excerpt (regex_v1, Sep 18, 2026)
uv tool install --python 3.13 "headroom-ai[all]" # CLI in a self-contained envSource link
Tags
README
1 — Install uv tool install python 3.13 "headroom ai[all]" CLI in a self contained env pip install "headroom ai[all]" Python — ships the CLI npm install headroom ai TypeScript SDK only — no CLI Install Granular extras: , , (Kompress v2 base), , , (optional HNSW backend — needs a...
For agents
This page has a .md twin and JSON over the API.