headroom/wiki
Tejas Chopra d5fd84b8df docs(configuration): document LiteLLM as the source for limits and prices
The documented resolution order was 'built-in defaults -> models.json -> env ->
SDK args' with no mention of LiteLLM, which is misleading in a way that costs
users work: it reads as though editing models.json is the only way to correct a
wrong limit or price, when public models are resolved from LiteLLM and stay
current on their own.

Restated as an explicit first-match-wins list for both limits and pricing:
explicit config -> LiteLLM -> built-in tables -> pattern -> default, noting that
step 3 is a fallback for installs without LiteLLM (the dep is gated
python_version < '3.14') and models it doesn't know.

Also:
- Both trees used 'gpt-5: 256000' and 'gpt-5: [5.00, 15.00]' as the example
  overrides. Both numbers are wrong (272K input, $1.25/$10.00) and gpt-5 is now
  a known model, so the example taught readers to override a correct value with
  a stale one. Swapped for a fine-tune and a private deployment -- the cases
  configuration is actually for.
- Noted that limits are an INPUT budget (max_input_tokens), not the total
  window: gpt-5 is 272K in + 128K out, not 400K of prompt room.
- Added gpt-4.1 / gpt-5 / o4 to the pattern-inference table and stated that
  matching prefers the most specific prefix, so gpt-4.1 is not treated as gpt-4.

Docs-only; no code change.
2026-08-04 16:14:09 -07:00
..
overrides new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
plans fix: add anthropic pre-upstream timeouts 2026-04-21 09:48:32 +07:00
screenshots new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
stylesheets new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
agno.md docs: sync README + benchmarks with code (drop retired IntelligentContext/RollingWindow) (#1545) 2026-06-28 22:36:41 -07:00
api.md docs: sync README + benchmarks with code (drop retired IntelligentContext/RollingWindow) (#1545) 2026-06-28 22:36:41 -07:00
ARCHITECTURE.md docs: sync README + benchmarks with code (drop retired IntelligentContext/RollingWindow) (#1545) 2026-06-28 22:36:41 -07:00
benchmarks.md fix(telemetry): switch anonymous telemetry to opt-in (off by default) (#1223) 2026-06-20 21:26:04 -07:00
ccr.md docs: sync README + benchmarks with code (drop retired IntelligentContext/RollingWindow) (#1545) 2026-06-28 22:36:41 -07:00
cli.md fix: remove rtk and lean-ctx CLI context tools (#2677) 2026-07-30 22:59:41 -07:00
compression.md fix(cli): proxy/perf/wrap UX cleanup + perf --hours correctness 2026-05-07 16:43:35 -07:00
configuration.md docs(configuration): document LiteLLM as the source for limits and prices 2026-08-04 16:14:09 -07:00
docker-install.md fix: remove rtk and lean-ctx CLI context tools (#2677) 2026-07-30 22:59:41 -07:00
errors.md new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
filesystem-contract.md fix: remove rtk and lean-ctx CLI context tools (#2677) 2026-07-30 22:59:41 -07:00
getting-started.md Clarify uv tool install path on macOS (#1196) 2026-07-15 21:06:30 +00:00
image-compression.md new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
index.md Clarify uv tool install path on macOS (#1196) 2026-07-15 21:06:30 +00:00
integration-guide.md fix: remove rtk and lean-ctx CLI context tools (#2677) 2026-07-30 22:59:41 -07:00
langchain.md new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
LATENCY_BENCHMARKS.md new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
learn.md fix(cli): harden all CLI surfaces + fix docs accuracy (#1491) 2026-06-27 14:48:43 -07:00
LIMITATIONS.md docs: sync README + benchmarks with code (drop retired IntelligentContext/RollingWindow) (#1545) 2026-06-28 22:36:41 -07:00
macos-deployment.md Clarify uv tool install path on macOS (#1196) 2026-07-15 21:06:30 +00:00
mcp.md docs: document HEADROOM_CONFIG_DIR / HEADROOM_WORKSPACE_DIR filesystem contract 2026-04-16 19:24:17 -05:00
memory.md feat(memory): add opt-in Apple-GPU (MPS) embedding runtime (#766) 2026-06-11 12:59:20 -05:00
metrics.md fix(cli): harden all CLI surfaces + fix docs accuracy (#1491) 2026-06-27 14:48:43 -07:00
network-diff-capture.md feat: add differential network capture harness (#761) 2026-06-08 22:18:31 -07:00
persistent-installs.md docs: document HEADROOM_CONFIG_DIR / HEADROOM_WORKSPACE_DIR filesystem contract 2026-04-16 19:24:17 -05:00
proxy.md fix(compress): resolve the /v1/compress tokenizer per model, and document the real contract (#2743) 2026-08-03 12:20:33 -07:00
quickstart.md Clarify uv tool install path on macOS (#1196) 2026-07-15 21:06:30 +00:00
sdk.md new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
shared-context.md new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
strands.md docs: sync README + benchmarks with code (drop retired IntelligentContext/RollingWindow) (#1545) 2026-06-28 22:36:41 -07:00
text-compression.md new docs UI + ts doc coverage 2026-04-12 13:15:58 +06:00
transforms.md docs: sync README + benchmarks with code (drop retired IntelligentContext/RollingWindow) (#1545) 2026-06-28 22:36:41 -07:00
troubleshooting.md fix: skip Magika backend on x86 CPUs without AVX2 (#1162) 2026-06-30 13:34:17 -05:00
typescript-sdk.md fix(compress): resolve the /v1/compress tokenizer per model, and document the real contract (#2743) 2026-08-03 12:20:33 -07:00
vertex.md chore: remove committed node_modules + stray/internal markdown (repo hygiene) (#1528) 2026-06-27 23:32:54 -07:00