PyRank
headroomlabs-ai

headroom-ai

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
PyPI GitHub
More links
Download Stats Changelog Issues
Verified repo
Monthly downloads
345.9K
Weekly downloads
99.9K
GitHub stars
74.9K

Downloads in the 30 and 7 days to October 10, 2026. Refreshed weekly.

Package Information

Latest Version
0.41.0
Requires Python
>=3.10
Licence
Apache-2.0
Last Release
2 days ago
Author
Headroom Contributors
First Release
January 10, 2026
Total Releases
223
Python Versions
3 3.10 3.11 3.12 3.13 3.14
No reported malware or high/critical advisories · Details

The current version has no OSV.dev malware reports and no critical or high-severity vulnerabilities.

Package Insights

What's this?
Score breakdown - each component scores 0-100, weighted by percentage
Maintenance
100
Popularity
98
Adoption
95
Community
70
Provenance
100
How the maintenance status was determined
Last commit
5 days ago
Monthly downloads
345,881
• Active
Activity within 30 days
Stable
Activity within 31-180 days
Minimal
Activity within 181-365 days, or no activity data
At Risk
No activity for > 365 days, but > 10,000 monthly downloads
Archived
Repository flagged as archived on GitHub
How the popularity category was determined
Monthly downloads
345,881
Stars
74,942
Stars per 1k downloads
216.67
Industry Standard
> 10,000,000 monthly downloads
Hidden Gem
< 0.5 stars per 1k downloads and > 100,000 monthly downloads
• Community Favorite
> 5 stars per 1k downloads
Rising Star
Balanced ratio of stars to downloads
Unknown
Fewer than 1,000 monthly downloads, or no star data
How download momentum is calculated
Week daily avg
14,271
Month daily avg
11,529
Momentum
+23.8%
((week_daily_avg - month_daily_avg) / month_daily_avg) * 100
More insights and metrics
Python version support tiers
requires_python
>=3.10
Cutting Edge
Minimum supported version is 3.14 or newer
Modern
Minimum supported version is 3.11 to 3.13
• Legacy
Supports 3.10 or older (or Python 2)
Unknown
No requires_python specified or unparseable
License categories
License
Apache-2.0
• Permissive
MIT, Apache, BSD, ISC, Unlicense, CC0, etc.
Copyleft
GPL, LGPL, AGPL, MPL, EPL, etc.
Proprietary
Commercial, all rights reserved, custom EULAs
Unknown
No license specified, or none of the above match
How the release cadence was determined
Last release
1 days ago
Total releases
223
Releases/year
292.8
• Rapid
Last release within 365 days and > 12 releases/year
Regular
Last release within 365 days
Slow
Last release 366-730 days ago
Stalled
Last release > 730 days ago, or no releases
Unknown
No usable release date available
How contributor risk was determined
Contributors
320
Monthly downloads
345,881
High Load
≤ 2 contributors and ≥ 50,000 monthly downloads
Moderate Load
< 10 contributors and ≥ 500,000 monthly downloads
Low Load
< 25 contributors and ≥ 5,000,000 monthly downloads, or sole maintainer with ≥ 10,000 monthly downloads
• Balanced
Enough contributors for the package's popularity
Unknown
No contributor data available
Engagement
82
 
Issue Burden
2.7
per 1k stars
Discussions
1.1
per 1k stars
Fork Ratio
5.5%
contrib / forks
Stale Release
No
 
PR Velocity
Active
 
Not all downloads include detailed metadata. Breakdowns reflect the subset that does.

Downloads by OS

Linux 8.7K
Windows 1.9K
macOS 689

Python Versions

3.12
66.2% 7.3K
3.13
12.2% 1.3K
3.14
8.4% 919
3.15
7.6% 839
3.11
5.6% 611

Top Countries

1. US US
8.3K
2. CN CN
369
3. ID ID
340
4. IN IN
278
5. IE IE
267
6. DE DE
253
7. KR KR
223
8. FR FR
180
9. TR TR
175
10. SG SG
155

Weekly Downloads

GitHub Stars

Dependencies

11
96 optional dependencies
  • accelerate>=0.20.0[voice-train]
    extra == "voice-train"
  • agno>=1.0.0[agno]
    extra == "agno"
  • anthropic>=0.18.0[dev]
    extra == "dev"
  • anthropic>=0.18.0[evals]
    extra == "evals"
  • any-llm-sdk>=1.0.0[anyllm]
    python_full_version >= "3.11" and extra == "anyllm"
  • autogen-agentchat>=0.7[autogen]
    extra == "autogen"
  • boto3>=1.41.0[bedrock]
    extra == "bedrock"
  • botocore>=1.41.0[bedrock]
    extra == "bedrock"
  • cryptography>=50.0.0[dev]
    extra == "dev"
  • datasets>=5.0.1[voice-train]
    extra == "voice-train"
  • datasets>=5.0.1[evals]
    extra == "evals"
  • fastapi>=0.100.0[proxy]
    extra == "proxy"
  • fastapi>=0.100.0[dev]
    extra == "dev"
  • fastembed>=0.4.0[relevance]
    extra == "relevance"
  • gunicorn>=21.0.0[proxy-prod]
    sys_platform != "win32" and extra == "proxy-prod"
  • headroom-ai[all]
    extra == "all"
  • headroom-ai[proxy-prod]
    extra == "proxy-prod"
  • headroom-ai[sandbox]
    extra == "sandbox"
  • headroom-ai[voice-train]
    extra == "voice-train"
  • hnswlib>=0.8.0[dev]
    extra == "dev"
  • hnswlib>=0.8.0[vector]
    extra == "vector"
  • httpx>=0.24.0[proxy]
    extra == "proxy"
  • httpx>=0.24.0[dev]
    extra == "dev"
  • httpx>=0.24.0[mcp]
    extra == "mcp"
  • huggingface-hub<2.0,>=1.5.0[ml]
    extra == "ml"
  • jinja2>=3.0.0[reports]
    extra == "reports"
  • langchain-core<4.0,>=1.3.3[langgraph]
    extra == "langgraph"
  • langchain-core<4.0,>=1.3.3[langchain]
    extra == "langchain"
  • langchain-ollama>=0.2.0[dev]
    extra == "dev"
  • langchain-openai<2.0,>=1.1.14[langchain]
    extra == "langchain"
  • langchain-openai<2.0,>=1.1.14[langgraph]
    extra == "langgraph"
  • langgraph<2.0,>=1.0[langgraph]
    extra == "langgraph"
  • litellm<2.0,>=1.96.2[dev]
    extra == "dev"
  • magika>=0.6.0[proxy]
    extra == "proxy"
  • mcp<2.0.0,>=1.28.1[mcp]
    extra == "mcp"
  • mcp<2.0.0,>=1.28.1[proxy]
    extra == "proxy"
  • mem0ai<3.0,>=2.0.0[memory-stack]
    extra == "memory-stack"
  • mypy>=1.0.0[dev]
    extra == "dev"
  • neo4j<7.0,>=5.20.0[memory-stack]
    extra == "memory-stack"
  • numpy>=1.24.0[dev]
    extra == "dev"
  • numpy>=1.24.0[relevance]
    extra == "relevance"
  • numpy>=1.24.0[evals]
    extra == "evals"
  • ollama>=0.4.0[dev]
    extra == "dev"
  • onnxruntime>=1.24.0[proxy]
    python_full_version >= "3.11" and extra == "proxy"
  • onnxruntime<2,>=1.7[image]
    python_full_version >= "3.13" and extra == "image"
  • onnxruntime>=1.24.0[voice]
    python_full_version >= "3.11" and extra == "voice"
  • openai>=1.0.0[dev]
    extra == "dev"
  • openai>=1.0.0[evals]
    extra == "evals"
  • openai>=2.14.0[proxy]
    extra == "proxy"
  • openpyxl>=3.1.0[spreadsheet]
    extra == "spreadsheet"
  • openpyxl>=3.1.0[dev]
    extra == "dev"
  • opentelemetry-exporter-otlp-proto-http>=1.24.0[otel]
    extra == "otel"
  • opentelemetry-exporter-otlp-proto-http>=1.24.0[dev]
    extra == "dev"
  • opentelemetry-sdk>=1.24.0[otel]
    extra == "otel"
  • opentelemetry-sdk>=1.24.0[dev]
    extra == "dev"
  • orjson>=3.9.14[proxy]
    platform_python_implementation != "PyPy" and extra == "proxy"
  • pillow>=12.3.0[image]
    extra == "image"
  • pre-commit>=3.0.0[dev]
    extra == "dev"
  • pytest>=7.0.0[dev]
    extra == "dev"
  • pytest-asyncio>=0.21.0[dev]
    extra == "dev"
  • pytest-cov>=4.0.0[dev]
    extra == "dev"
  • qdrant-client<2.0,>=1.9.0[memory-stack]
    extra == "memory-stack"
  • rapidocr<4,>=3.0[image]
    python_full_version >= "3.13" and extra == "image"
  • rapidocr-onnxruntime<2,>=1.4.0[image]
    python_full_version < "3.13" and extra == "image"
  • respx>=0.20.0[dev]
    extra == "dev"
  • ruff==0.16.8[dev]
    extra == "dev"
  • scikit-learn>=1.3.0[evals]
    extra == "evals"
  • sentence-transformers<7.0,>=2.2.0[dev]
    extra == "dev"
  • sentence-transformers<7.0,>=2.2.0[evals]
    (platform_machine != "x86_64" and extra == "evals") or (sys_platform != "darwin" and extra == "evals")
  • sentence-transformers<7.0,>=2.2.0[memory]
    (platform_machine != "x86_64" and extra == "memory") or (sys_platform != "darwin" and extra == "memory")
  • sentence-transformers>=2.2.0[pytorch-mps]
    sys_platform == "darwin" and extra == "pytorch-mps"
  • sentencepiece>=0.1.99[image]
    extra == "image"
  • sqlite-vec>=0.1.6[memory]
    extra == "memory"
  • sqlite-vec>=0.1.6[dev]
    extra == "dev"
  • sqlite-vec>=0.1.6[proxy]
    extra == "proxy"
  • starlette>=0.27.0[mcp]
    extra == "mcp"
  • strands-agents>=0.1.0[strands]
    extra == "strands"
  • torch>=2.12.1[pytorch-mps]
    sys_platform == "darwin" and extra == "pytorch-mps"
  • torch>=2.12.1[voice]
    (platform_machine != "x86_64" and extra == "voice") or (sys_platform != "darwin" and extra == "voice")
  • torch>=2.12.1[ml]
    (platform_machine != "x86_64" and extra == "ml") or (sys_platform != "darwin" and extra == "ml")
  • trafilatura>=1.6.0[html]
    extra == "html"
  • transformers<6.0,>=5.5.0[ml]
    extra == "ml"
  • transformers<6.0,>=5.5.0[proxy]
    extra == "proxy"
  • transformers<6.0,>=5.5.0[voice]
    extra == "voice"
  • tree-sitter<0.27,>=0.25.2[code]
    extra == "code"
  • tree-sitter-language-pack<1.0,>=0.10.0[code]
    extra == "code"
  • uvicorn<1.0,>=0.23.0[dev]
    extra == "dev"
  • uvicorn<1.0,>=0.23.0[mcp]
    extra == "mcp"
  • uvicorn<1.0,>=0.23.0[proxy]
    extra == "proxy"
  • watchdog>=4.0.0[proxy]
    (python_full_version < "3.14" and extra == "proxy") or (sys_platform != "darwin" and extra == "proxy")
  • websockets>=13.0[dev]
    extra == "dev"
  • websockets>=13.0[proxy]
    extra == "proxy"
  • xlrd>=2.0.1[dev]
    extra == "dev"
  • xlrd>=2.0.1[spreadsheet]
    extra == "spreadsheet"
  • xlwt>=1.3.0[dev]
    extra == "dev"
  • zstandard>=0.20.0[proxy]
    extra == "proxy"

Used By

14
View all 14 dependents

Repository details

Forks
5.8K
Issues
200
Last Commit
6 days ago
Contributors
320
Open PRs
214
Archived
No

Data and sources

Tracking Since
September 26, 2026
Data Updated
October 11, 2026
Data Freshness
Fresh
Keywords
llm openai anthropic claude gpt context token optimization compression caching proxy ai machine-learning
Sources and methodology