headroomlabs-ai/headroom
Documented errors, page 2 of 4. Back to headroomlabs-ai/headroom
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Unsupported api_style | validation | error | configuration, provider, dispatch, python |
| model_limit is required. Provide it via kwargs or configure… | validation | error | configuration, pipeline, model-limits, precondition |
| sentence-transformers is required for LocalEmbedder… | exception | error | dependencies, import, embeddings, memory, optional-extra |
| unserializable config value | exception | error | serialization, toml, json, configuration |
| Error: MCP dependencies not installed | console | error | cli, mcp, serve, optional-dependencies, importerror |
| HEADROOM_LEARN_CLI= is not a supported CLI. Valid values | validation | error | configuration, env-var, cli, validation |
| Proxy process exited unexpectedly. | console | critical | proxy, process-crash, monitoring, logging, headroom, cli |
| token endpoint returned HTTP | exception | error | oauth2, network, http, identity-provider |
| hnswlib is required for HNSWVectorIndex. Install with: pip… | exception | error | dependencies, native, vector-index, hnsw, memory |
| SmartCrusher: invalid protected_patterns regex | validation | error | regex, validation, smart-crusher, protected-patterns |
| unknown tool | exception | error | binaries, registry, path-lookup, keyerror |
| Attempted to start Headroom proxy, but it was not reachable… | exception | error | proxy, auto-start, timeout, openclaw |
| failed | exception | error | build, ci, nodejs, environment |
| headroom-oauth2 misconfigured | exception | critical | oauth2, configuration, plugin, fail-closed, startup |
| Memories and do not form a reciprocal supersession edge | validation | error | cli, memory, supersession, data-integrity, valueerror |
| ollama package required. Install with: pip install ollama | exception | error | ollama, import-error, optional-dependency, evals, local-llm |
| tar failed for | exception | error | npm, tar, verification, release, spawn |
| Cannot auto-start Headroom at | exception | error | proxy, port-conflict, auto-start, openclaw |
| Error: 'codex' not found in PATH. | console | error | path, installation, codex, cli, headroom |
| Evaluation interrupted. | console | warning | cli, evals, keyboard-interrupt, cancellation |
| ` ` produced no output for s. Check network connectivity… | exception | error | network, timeout, cli, learn, subprocess |
| archive did not contain expected member | exception | error | python, binaries, extraction, registry, archive, packaging |
| httpx is required for OllamaEmbedder. Install it with: pip… | exception | error | dependencies, import, ollama, embeddings, memory |
| rollout worker snapshot digest mismatch | exception | error | integrity, rollout, digest, worker-handoff |
| binary cache directory is not writable | exception | error | python, binaries, filesystem, permissions |
| Unknown compression-only benchmark | exception | error | validation, suite-config, evals, naming, typo |
| Kompress requires onnxruntime or torch. Install with: pip… | exception | error | dependency, import-error, onnx, pytorch, installation |
| tree-sitter is not installed. Install with: pip install… | exception | error | dependency, import-error, tree-sitter, installation |
| Unknown agent: . Available | exception | error | plugin, registry, learn, configuration |
| = is not an integer | validation | error | configuration, env-vars, oauth2, fail-closed |
| position must be one of | exception | error | validation, evals, adversarial, python, input-validation |
| ` ` did not respond within s. Check network connectivity… | exception | error | timeout, cli, subprocess, configuration |
| Assets directory must be empty to avoid stale tarballs | exception | error | build, release, ci, hygiene |
| failed to extract | exception | error | python, binaries, extraction, archive, corruption, disk-full |
| HuggingFace datasets required for this loader. Install… | exception | error | dependency, import, evals, datasets, huggingface, extras |
| : state_dict mismatch (missing= , unexpected= )… | exception | error | pytorch, state-dict, model-loading, onnx |
| neither `objdump` nor `llvm-objdump` is on PATH; install… | exception | error | tooling, ci, python, packaging, environment |
| unknown importance context | exception | error | validation, rust, pyo3, error-detection |
| Failed to update memory | exception | error | python, mem0, update, valueerror, runtime-wrap, memory-backend |
| target_ratio list length | validation | error | validation, batch-api, kompress, precondition |
| unknown rollout channel | exception | error | configuration, rollout, validation, enum |
| merged.pt missing ' '. Found: . This script targets the v2… | exception | error | pytorch, checkpoint, huggingface, onnx, export |
| openai package not installed. Install with: pip install… | exception | error | python, import, dependency, openai, mem0, memory-backend |
| Spreadsheet not found | exception | error | filesystem, validation, precondition, spreadsheet |
| Strands SDK is required for this integration. Install with… | exception | error | strands, aws, import-error, optional-dependency |
| Error: 'grok' not found in PATH. | console | error | path, installation, grok, xai, cli, headroom |
| openai_api_key is required for OpenAI embedder | validation | error | memory, embeddings, openai, credentials, configuration |
| : distributed via PyPI only; `pip install headroom-ai`… | exception | error | python, binaries, pypi, platform-not-supported, packaging |
| mode must be 'token' or 'cache' | exception | error | testing, harness, validation, enum |
| Error: 'omp' not found in PATH. | console | error | cli, path, dependency, omp, oh-my-pi, wrap |
| recommendations IO error at | exception | error | configuration, environment-variables, startup |
| Shutting down... | console | info | cli, proxy, shutdown, keyboard-interrupt, exit-code |
| fixture declares transform= but lives under | validation | warning | security, dns-rebinding, host-header, http-404 |
| Error: 'kimi' (or 'kimi-cli') not found in PATH. | console | error | path, installation, kimi, moonshot, cli, headroom |
| failed to read simulator config | console | error | rust, config, io, filesystem |
| could not find a rev for | exception | error | pre-commit, ruff, config, yaml |
| recommendations TOML parse error | exception | warning | security, loopback, http-404, admin-endpoints |
bedrock_eventstream_missing_event_type Bedrock message missing required `:event-type` header | exception | error | bedrock, eventstream, wire-format, sse, rust |
| GitHub device authorization expired. | exception | error | auth, oauth, github, device-flow, timeout, expiration |
| not one of | validation | error | settings, validation, enum |
| token_url must be https (loopback http allowed for tests… | validation | error | oauth2, security, tls, configuration |
| OpenAI API failed after | exception | error | api, openai, retry, rate-limit, embeddings, network |
| ` ` failed (exit ) | exception | error | cli, subprocess, exit-code, learn, auth |
| must be >= | validation | error | settings, validation, range |
| offline mode (HEADROOM_BINARIES_OFFLINE=1) but fetch… | exception | error | python, binaries, offline, air-gapped, cache, environment |
| Invalid = ; expected 'byte_faithful' or 'legacy_json_kwarg | validation | error | env, config, validation |
| provider must be non-empty | validation | error | validation, session, provider, tracker |
| Headroom proxy not detected on default endpoints | exception | error | proxy, configuration, setup, openclaw |
| min_batch_bytes must be positive | exception | error | validation, configuration, batching |
| mem0 package not installed. Install with: pip install… | exception | error | python, import, dependency, mem0, memory-stack, memory-backend |
| Memory not found | validation | error | cli, memory, id-resolution, valueerror |
| token endpoint unreachable | exception | error | oauth2, network, dns, timeout, retryable |
| Error: MCP SDK not installed. | console | error | cli, mcp, optional-dependencies, importerror |
| expected a number, got | validation | error | settings, validation, types |
| Expected npm pack to produce | exception | error | npm, release, build, pack |
| Unknown store backend | validation | error | memory, configuration, enums, version-drift |
| binary cache directory parent is not writable | exception | error | python, binaries, filesystem, permissions, containers |
| Invalid semantic version | validation | error | versioning, release, validation |
| tiktoken encoding previously failed to load | exception | error | tokenizer, tiktoken, network, timeout, caching |
| Not Found | http | error | http, authorization, network |
| No tokenizer available for | exception | error | tokenizer, registry, fallback, dependencies |
| Unsupported spreadsheet format | validation | error | validation, file-format, spreadsheet, precondition |
| Unknown embedder backend | validation | error | memory, embeddings, enums, configuration |
| unsupported headroom-bench proxy mode | exception | error | benchmark, config, proxy, validation |
| does not contain headroom/_core native extension | exception | error | python, pyo3, maturin, rust, wheel |
| comparator ccr not implemented (Phase 0) | exception | warning | security, csrf, origin, http-403 |
| items_json must be a JSON array, got | panic | error | python, json, pyo3, ffi, type-mismatch |
| Error: litellm required for --answer-model. Run: pip… | console | error | cli, evals, litellm, optional-dependencies |
| Error: 'openhands' not found in PATH. | console | error | cli, path, dependency, openhands, wrap |
| Unknown backend | validation | error | memory, configuration, validation |
| headroom proxy exited with code | exception | critical | process, proxy, startup, subprocess, ci |
| ` ` did not emit a final `result` event. First chars of… | exception | error | cli, streaming, protocol, learn, json |
| pyproject.toml must contain one exact Ruff pin in… | exception | error | ruff, pyproject, version-pinning, linting |
| rollout worker registry digest mismatch | exception | error | integrity, rollout, digest, worker-handoff |
| backend does not support OpenAI streaming | exception | error | python, backend, streaming, not-implemented, openai-compat, sse |
| is required when backend is EXTERNAL; set it to the… | validation | error | memory, configuration, plugins, entry-points |
| Error: 'openclaude' not found in PATH. | console | error | path, installation, openclaude, cli, headroom |
| Ambiguous ID ' '. Matches | validation | error | cli, memory, id-resolution, ambiguity, valueerror |
| ccr_originals list length | validation | error | validation, batch-api, kompress, ccr, precondition |
| Decoding not available for | exception | warning | tokenizer, huggingface, fallback, network, not-implemented |