ErrLookup › headroomlabs-ai/headroom
headroomlabs-ai/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. · Python · 754 source files
Analyzed at 322425c43b on 2026-08-15. 380 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| deployment profile ' ' is corrupt ( ) | exception | error | manifest, corruption, installation, persistence, schema-drift |
| No loadable ONNX artifact in | exception | error | onnx, onnxruntime, model-loading, network, huggingface |
| Budget exceeded for period | http | error | budget, cost-control, http-429, proxy, spend-limit |
| Rate limited. Retry after | http | warning | rate-limit, http-429, proxy, retry-after, throttling |
| token endpoint response had no access_token | exception | error | oauth2, authentication, configuration, network |
| unknown rollout feature(s) in | exception | error | rollout, configuration, feature-flags |
| unknown Headroom harness config field | exception | warning | testing, harness, api-misuse, typo |
| Windows environment mutation is missing a variable name | validation | error | windows, manifest, rollback, corruption, internal-state |
| No optimizer registered for | exception | error | cache, registry, provider, keyerror, lazy-import |
| Error: Copilot BYOK mode requires a provider API key… | console | error | authentication, api-key, byok, github-copilot, environment-variables, headroom |
| Invalid URL | exception | warning | url-validation, installer, defensive-check, configuration |
| Headroom OpenCode transport shim loaded without… | exception | error | environment, configuration, opencode, plugin, pip |
| GitHub device authorization returned an invalid response. | exception | error | network, auth, oauth, github, device-flow, proxy |
| LangChain is required for this integration. Install with… | exception | error | memory, langchain, import-error, chat-history |
| No agents matched the requested filter. | console | warning | cli, mcp, agent-detection, filter, system-exit |
| Magika is required for ML-based content detection. Install… | exception | error | dependency, import, ml, content-detection, python |
| Invalid entry | validation | error | configuration, network, cidr, validation, security |
| max_sessions must be > 0 | validation | error | validation, constructor, lru, beta-headers, configuration |
| tiktoken is required for OpenAI provider. Install with: pip… | exception | error | dependency, installation, tokenizer, openai, python |
| Error: '--model auto' is not supported in Copilot BYOK… | console | error | byok, model-selection, github-copilot, validation, headroom, cli |
| : state_dict mismatch against (missing= , unexpected= )… | exception | error | pytorch, state-dict, version-skew, model-loading |
| merged.pt for is missing ; found keys: . This checkpoint… | exception | error | pytorch, checkpoint, model-loading, cache |
| is read-only; mutate its fields instead | exception | warning | testing, harness, api-misuse |
| settings validation failed: unknown= | validation | error | settings, validation, api |
| Windows environment mutation is missing a valid scope | validation | error | windows, manifest, rollback, validation, schema |
| Headroom modified prompt semantics! Differences | exception | error | semantics, llm-judge, evals, prompt-preservation, regression |
| Failed to extract archive | exception | error | installer, archive, corruption, network, extraction |
| Error: Memory eval V2 dependencies not installed. | console | error | cli, evals, optional-dependencies, importerror, v2 |
| conflicting values supplied for | validation | error | settings, configuration, conflict |
| Headroom OpenCode wrap blocked direct HTTP/2 connection to | exception | error | proxy, nodejs, http2, opencode, monkey-patching |
| SmartCrusher: custom `relevance_config` / `scorer`… | exception | error | not-implemented, rust-port, breaking-change, smart-crusher |
| unknown ProxyConfig field | exception | warning | testing, harness, builder, typo |
| Agno is required for this integration. Install with: pip… | exception | error | agno, import-error, optional-dependency, integration, feature-flag |
| does not match config_payload | exception | error | testing, deployment, configuration, drift |
| deployment env missing | exception | error | testing, deployment, environment |
| expected a JSON object of header name/value strings | validation | error | settings, json, headers |
| Model ' ' does not have batch output pricing | validation | error | pricing, batch-api, validation |
| native detect_content_type exceeded | exception | warning | timeout, watchdog, native, rust, content-detection |
| codebase-memory-mcp binary not found in archive | exception | error | installer, archive, packaging, download, mismatch |
| model.safetensors: state_dict mismatch against… | exception | critical | safetensors, state-dict, model-loading, architecture-mismatch |
| Bedrock with temporary credentials (AWS_SESSION_TOKEN)… | exception | error | python, aws, bedrock, optional-dependency, credentials, fail-fast |
| sha256 mismatch for : expected , got | exception | error | python, binaries, integrity, sha256, security, mirror |
| must be a dataclass | exception | error | testing, dataclass, types |
| AutoGen is required for this integration. Install with: pip… | exception | error | autogen, import-error, optional-dependency, integration, package-naming |
| Error: 'opencode' not found in PATH. | console | error | cli, path, dependency, opencode, wrap, config-safety |
| failed to download after attempts | exception | error | python, binaries, network, download, retry, proxy, mirror |
| answerdotai/ModernBERT-base | exception | error | tokenizer, cache, offline, huggingface, transformers |
| ccr sqlite backend init failed | exception | error | compression, zstd, dependency, request-body |
| LangChain is required for this integration. Install with… | exception | error | langchain, import-error, optional-dependency, installation |
| module has no attribute | exception | error | imports, lazy-loading, attributeerror |
| Ollama API error | exception | error | ollama, api, embeddings, non-retryable, local-model |
| OPENAI_API_KEY environment variable required | exception | error | config, environment, api-key, benchmark, evals |
| Headroom proxy startup is disabled | exception | error | proxy, configuration, typescript, openclaw |
| unknown compaction format | validation | error | configuration, env-vars, validation, smart-crusher |
| ` ` exceeded the s hard cap. Raise… | exception | error | timeout, claude-cli, streaming, watchdog, configuration |
| OpenAI API error | exception | error | api, openai, embeddings, non-retryable, network |
| Proxy failed to start on port | exception | error | timeout, proxy, startup, performance, environment-variables, headroom |
| Invalid = ; expected 'enabled' or 'disabled | validation | error | configuration, environment, validation, proxy |
| must be a JSON object of header name/value strings | validation | error | configuration, json, headers, environment, cli |
| expected a boolean, got | validation | error | settings, validation, boolean |
| magika session lock poisoned | exception | error | encoding, utf-8, request-body, compression |
| No available port found in range | exception | error | network, ports, resource-exhaustion, headroom, cli |
| openai package required. Install with: pip install openai | exception | error | openai, import-error, optional-dependency, evals, configuration |
| Proxy exited with code | exception | critical | proxy, startup, subprocess, logging, headroom, cli |
| Unsupported platform | exception | error | platform, installer, binary, unsupported-os, environment |
| must be a positive integer number of seconds (got ) | validation | error | cli, wrap, environment-variable, configuration, runtimeerror |
| Error: Memory eval dependencies not installed. | console | error | cli, evals, optional-dependencies, importerror, system-exit |
| Failed to download codebase-memory-mcp from | exception | error | network, download, installer, github, wrapping |
| Unhandled AuthMode variant | exception | error | enum, policy, validation, exhaustiveness |
| Copilot OAuth token must not be empty. | validation | error | validation, auth, copilot, oauth, token |
| CrewAI is required for this integration. Install with: pip… | exception | error | crewai, import-error, optional-dependency, integration, dependency-conflict |
| ` ` returned unparseable output. First chars | exception | error | json-parsing, cli, llm-output, retryable |
| No usable Headroom launcher found. Tried PATH, local npm… | exception | error | proxy, installation, auto-start, environment, openclaw |
| anthropic package required. Install with: pip install… | exception | error | anthropic, import-error, optional-dependency, evals, configuration |
| Reading legacy .xls files requires xlrd. Install it with… | exception | error | dependencies, optional-extras, spreadsheet, legacy-formats, importerror |
bedrock_upstream_exception Bedrock stream emitted exception | exception | error | bedrock, streaming, upstream, sse, rust |
| ` ` not found in PATH. Install it or use a different… | exception | error | path, cli, subprocess, environment |
| httpx is required for Headroom Cloud mode: pip install httpx | exception | error | httpx, import-error, optional-dependency, asgi, cloud, lazy-import |
| unknown HeadroomConfig field | exception | error | config, sdk, fluent-api, typo |
| expected a finite number, got | validation | error | settings, validation, numbers, edge-case |
| Unknown provider | exception | error | configuration, validation, provider, evals, typo |
| lm-eval failed | exception | error | subprocess, benchmark, lm-eval, evals, harness |
| tiktoken encoding load timed out | exception | error | tokenizer, tiktoken, timeout, network, caching, ci |
| GitHub device authorization failed | exception | error | auth, oauth, github, device-flow, access-denied |
| No GitHub Copilot OAuth token is available. | exception | error | auth, copilot, oauth, cache, credentials |
| A tracker with key ' ' is already registered. Each tracker… | exception | error | subscription, quota, registry, uniqueness |
| No LLM API key found. headroom learn needs one of: export… | exception | critical | configuration, api-key, env-var, cli, bootstrap |
| Copilot token exchange returned an empty token. | exception | error | auth, copilot, token-exchange, entitlement, subscription |
| remote Kompress response field 'compressed' must be a string | validation | error | network, api-contract, json, kompress, remote-backend |
| failed with exit code | exception | error | build, ci, nodejs, release |
| Language ' ' is quarantined for code-aware compression. | exception | error | tree-sitter, language-support, validation, code-compression |
| OpenAI API key required. Set OPENAI_API_KEY environment… | exception | error | openai, api-key, configuration, evals, llm-judge |
| qdrant-neo4j backend requires additional packages. Install… | exception | error | python, import, dependency, mem0, qdrant, neo4j, docker, memory-stack |
| Error: Proxy dependencies not installed. Run: pip install… | console | error | cli, proxy, optional-dependencies, importerror |
| Language ' ' is not supported by tree-sitter. Supported… | exception | error | tree-sitter, language-support, validation |
| {model_id} | exception | error | model-loading, cache, offline, huggingface |
| Service reachable at | exception | error | proxy, configuration, port-conflict, openclaw |
| Copilot token exchange failed with HTTP | exception | error | auth, copilot, http, token-exchange, network |
| Error | console | error | cli, learn, model-detection, configuration, fail-fast |
| Unknown CLI model | validation | error | internal, model-selection, cli, validation |