HackerReposA FIELD GUIDE TO OPEN SOURCE
ProSponsor the shelf♧ 0
← Back to top all-time
headroomlabs-ai
headroom
Python2026–2026
headroomlabs-ai / headroom

headroom

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.

20Distinct people
26Mentions
0Explicit recommenders
79.5KGitHub stars
REPOSITORY AT A GLANCE

What to know before exploring

What it is

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.

GitHub

Where it is used

No documented product use was verified in the last source check.

What people are saying

No recommendation phrase was found in the indexed comments.

No classified warning is attached to this page. Read the discussions before treating silence as approval.

Also in these discussions

Mentioned in the same Hacker News threads. That is not proof they are substitutes.

This week on Hacker News

Nov 7–Nov 14 UTC · Direct repository links and separately labeled related project stories. Indexed through 11/14/2026, 5:04:57 PM UTC.

No direct repository links were found in the indexed HN discussions over the past seven days. Older discussions are available below.

Mentions over time

HN mentions by month26 dated mentions

Observed mentions: 2026-01-13 16:01:43 UTC to 2026-09-04 14:53:06 UTC.

024682026-01-01 00:00:00 UTC to 2026-02-01 00:00:00 UTC (exclusive): 4 mentions; 3 submissions, 1 commentsJan 20262026-02-01 00:00:00 UTC to 2026-03-01 00:00:00 UTC (exclusive): 0 mentions; 0 submissions, 0 comments2026-03-01 00:00:00 UTC to 2026-04-01 00:00:00 UTC (exclusive): 2 mentions; 1 submissions, 1 comments2026-04-01 00:00:00 UTC to 2026-05-01 00:00:00 UTC (exclusive): 5 mentions; 0 submissions, 5 comments2026-05-01 00:00:00 UTC to 2026-06-01 00:00:00 UTC (exclusive): 4 mentions; 2 submissions, 2 commentsMay 20262026-06-01 00:00:00 UTC to 2026-07-01 00:00:00 UTC (exclusive): 8 mentions; 4 submissions, 4 comments2026-07-01 00:00:00 UTC to 2026-08-01 00:00:00 UTC (exclusive): 1 mentions; 1 submissions, 0 comments2026-08-01 00:00:00 UTC to 2026-09-01 00:00:00 UTC (exclusive): 1 mentions; 0 submissions, 1 comments2026-09-01 00:00:00 UTC to 2026-10-01 00:00:00 UTC (exclusive): 1 mentions; 1 submissions, 0 commentsSep 2026

Counts come from the repository’s dated source evidence. Index cutoff: 2026-11-02 08:16:59 UTC.

View mention counts and date ranges
UTC ranges include their start and exclude their end. Select a period to filter the source evidence.
PeriodStart (UTC)End (exclusive, UTC)MentionsSubmissionsComments
Jan 20262026-01-01 00:00:00 UTC2026-02-01 00:00:00 UTC431
Feb 20262026-02-01 00:00:00 UTC2026-03-01 00:00:00 UTC000
Mar 20262026-03-01 00:00:00 UTC2026-04-01 00:00:00 UTC211
Apr 20262026-04-01 00:00:00 UTC2026-05-01 00:00:00 UTC505
May 20262026-05-01 00:00:00 UTC2026-06-01 00:00:00 UTC422
Jun 20262026-06-01 00:00:00 UTC2026-07-01 00:00:00 UTC844
Jul 20262026-07-01 00:00:00 UTC2026-08-01 00:00:00 UTC110
Aug 20262026-08-01 00:00:00 UTC2026-09-01 00:00:00 UTC101
Sep 20262026-09-01 00:00:00 UTC2026-10-01 00:00:00 UTC110

What Hacker News says

26 sources
I may be biased and interested as I'm going to give you an affiliate link, but really honestly Synthetic LLM provider is a beast! They provide perfect GLM5.2, awesome token/s, TTFT and price. Coupled with a local Headroom (https://github.com/headroomlabs-ai/headroom) you'll be able to use a LOT without hitting your 5h window :) Definitely the best $ value for me considering the reasonable performance of GLM5.2. They provide a rolling window quota, so you're never really out of quota contrary to other providers, you can adjust day to day. Check it out if interested : https://synthetic.new/?referral=kwjqga9QYoUgpZV --- Docs & all models : https://dev.synthetic.new/docs/api/models
In GLM 5.2 vs. Opus
I have good results with this setup: Hardware: - GPU: AMD 7900xtx, 24gb vram - CPU: AMD 5950x, AM4 - RAM: 64gb DDR4 3600 Software: - OS: Bazzite (atomic fedora - this machine is running Steam "big picture" mode on my TV when not in use for LLM tasks) - Virtualization: Podman Quadlets, which allows me to run container images as managed systemd units - Network: tailscale - Inference: llama.cpp vulkan (better performance than ROCM, though I'm keeping an eye on it in the future) - LLM API surface: llama-swap (running as a podman quadlet exposed via tailscale svc) allows running multiple models on a single endpoint. - Web/Chat Access: open-webui (running as podman quadlet exposed via tailscale svc) allows me to access any of the models I'm using for coding harness access for chat/general purpose queries via web browser. I also have the "condui
Read the rest
t" app for my iPhone that allows me to hit the same models from my phone. Models: - Qwen3.6-27B-MTP-UD-Q4_K_XL.gguf - Unsloth Q4 quant of the qwen 3.6 27B model weights, with MTP enabled. MTP is important as it improves the speed the model can run at. - Qwen3.6-35B-A3B-UD-Q4_K_XL.gguf - Unsloth Q4 quant of 35B-A3B. Not MTP right now because I was having some issues with it? - gemma-4-26B-A4B-it-UD-Q4_K_XL.gguf - Gemma 4, which I use sometimes via open-webui instead of Qwen, but I generally think Qwen does a better job Flags (specific for Qwen 27b, since that's primary model): - `-ngl 99` offload all layers to GPU - `-c 80000` 80K context window. I'd like this to be higher, but since my GPU also has to run the desktop session for the machine, I need to leave some VRAM overhead to keep the desktop from OOM-ing - `-np 1` single slot (no parallel request handling) - `--no-context-shift` error instead of silently sliding the context window when full - `--cache-reuse 256` reuse cached prefix in chunks of 256 tokens (prompt cache) - `-b 2048` logical batch size (tokens per submission) - `-ub 1024` physical micro-batch (per GPU pass) - `--cache-type-k q8_0 --cache-type-v q8_0` symmetric 8-bit K/V cache. Q8 is as low as I've been able to go without getting some issues with tool calling - `-fa on` flash attention - `--spec-type draft-mtp` use the model's built-in MTP as the draft model - `--spec-draft-n-max 3` propose up to 3 draft tokens per step - `--spec-draft-n-min 0` allow zero drafts if confidence is low - `--spec-draft-type-k q8_0 --spec-draft-type-v q8_0` KV quant for the draft path - `--reasoning-format deepseek` parse <think> blocks in proper format - `--chat-template-kwargs '{"enable_thinking": true}'` turns on Qwen's thinking mode on by default (clients can override) - `--jinja` use the GGUF's Jinja chat template - `--temp 0.6` moderate randomness (Qwen recommended value for coding) - `--top-p 0.95` nucleus sampling (Qwen recommended value for coding) - `--top-k 20` top-20 candidates (Qwen recommended value for coding) - `--min-p 0.0 disabled (Qwen recommended value for coding) Performance (27b, primary model): - ~65t/s for token generation - ~600 t/s for prompt processing. - If these numbers don't mean much to you, perceptually this feels about on-par with cloud model speed, maybe slightly faster. - ~30s cold start when swapping from a different model or starting up session from idle via llama-swap. I have llama-swap set up to unload the model after 10 min of idle, because I sometimes use this machine for gaming as well. A little annoying, but a small price to pay to be able to use the machine for other stuff (gaming) when I'm not using it with coding tasks. CLI/Harness: - Crush harness (https://github.com/charmbracelet/crush) less feature rich than Claude Code, but with a smaller system prompt and better built-in LSP support. I point it at the tailnet DNS (https://llama.<tailnet>:<port>) - Headroom (https://github.com/chopratejas/headroom) to maximize the 80k context window - Exa MCP for web search (https://exa.ai/) this alone makes the model far more useable. It's shocking how often the official claude code or codex harness get botblocked on web fetches, and the results of a good web fetch can be the difference between a good turn and a bad turn. A lot of people get hung up on whether Qwen 3.x models are "as smart as" some parallel Anthropic model. Most people seem to agree it's somewhere between Haiku 4.5 and Sonnet 4.5. Personally, I think the biggest thing that makes the Qwen 3.x series of models _feel_ good to use for coding workflows is that its the first time that tool calling actually works consistently on local models. If tool calling is busted even 5% of the time, it can totally ruin the flow. I think that's also why people tend to say the "harness is more important than the model" or whatever. I have a few other models set up but 27B with MTP is the best compromise of speed and quality that I've found. This setup works well enough for me that I dropped my personal Claude Code subscription. At work I'm still using frontier models, but personally I don't feel like I need that much power for anything I work on in my personal life. I'm "lucky" that I made the random financially unwise choice to buy a 7900XTX in late 2022 for $1k as a gaming card. I had no clue it would actually be a pretty decent LLM card 3-4 years later. Edit: sorry for the horrible formatting, I always forget that HN doesn't actually do markdown :(
In Ask HN: Has anyone replaced Claude/GPT with a local model for daily coding?
The github seems to be a better source, since it supports JavaScript and python https://github.com/chopratejas/headroom (4 points, 16 days ago) https://news.ycombinator.com/item?id=48155888 But we also seem to have a couple of Show HN from another of the contributors.. extraheadroom.com which uses this library, but bundles it further: Show HN: Headroom – Get 2x Claude Code usage by optimizing input data (2 points, 60 days ago) https://news.ycombinator.com/item?id=47602591
In Headroom compresses everything your AI agent reads before it reaches the LLM
Since this site seems to have an allergy to information density and usability, here's the GH: https://github.com/mksglu/context-mode Some discussion about this from a couple of months ago: https://news.ycombinator.com/item?id=47193064 Similar tools in this space: RTK:CLI proxy that reduces LLM token consumption: https://github.com/rtk-ai/rtk 8v: One CLI for you and your AI agent. Posted here a few days ago: https://news.ycombinator.com/item?id=47914963 Headroom:The Context Optimization Layer for LLM: https://github.com/chopratejas/headroom Of these, it looks like RTK and 8v are somewhat equivalent, while headroom is complementary. Although this does perhaps go further than rtk/v8.
In Context Mode v1.0.0

Showing the 15 most recent of 26 sources. Enable JavaScript to search and browse every indexed mention.

MAKE YOURSELF AT HOME

A few shortcuts

/
Search the collection
?
Open this guide
Esc
Close dialogs and navigation

Your saved repositories and interests stay in this browser.