headroomlabs-ai/headroom
Documented errors, page 3 of 4. Back to headroomlabs-ai/headroom
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| headroom proxy was not ready at | exception | error | timeout, proxy, startup, network, ci |
| could not read pipeline config file | exception | error | encoding, utf-8, request-body, compression |
| expected one Ruff dev dependency, found | exception | error | ruff, pyproject, dependencies, linting |
| MCP SDK not installed. Install with: pip install mcp | exception | error | mcp, optional-dependencies, importerror, ccr |
| Remote Headroom proxy not reachable at | exception | error | proxy, network, remote, configuration, openclaw |
| sqlite-vec is required for SQLiteVectorIndex. Install with… | exception | critical | sqlite-vec, import-error, environment, optional-dependency |
| comparator cache_aligner not implemented (Phase 0) | exception | warning | security, csrf, origin, http-403, browser |
| request was refused by safety classifiers | exception | error | anthropic, llm, api, safety, eval |
| Invalid = ; expected positive int | validation | error | configuration, environment, validation, lru-cache |
| Encoding not available for | exception | warning | tokenizer, huggingface, fallback, network, not-implemented |
| Error: 'goose' not found in PATH. | console | error | path, installation, goose, rust, cli, headroom |
| simulator config is not valid JSON | console | error | rust, config, json, serde |
| compressor is already registered | exception | error | registry, duplicate, plugin |
| max_batch_bytes must be at least min_batch_bytes | exception | error | validation, configuration, batching |
| metrics encode error | http | error | prometheus, metrics, observability, encoding, rust |
| rollout worker policy version mismatch | exception | error | versioning, rollout, policy, worker-handoff |
| backend does not support OpenAI format | exception | error | python, backend, not-implemented, openai-compat |
| expected one locked Ruff package, found | exception | error | uv, lockfile, ruff, dependencies |
| failed to load tokenizer for | exception | error | compression, deflate, zlib, corrupt-body, request-body |
| Reading .xlsx files requires openpyxl. Install it with: pip… | exception | error | dependencies, optional-extras, spreadsheet, importerror |
| Error: 'aider' not found in PATH. | console | error | path, installation, aider, python, cli, headroom |
| items_json must be JSON | panic | error | python, json, pyo3, ffi, validation |
| token endpoint returned non-JSON | exception | error | oauth2, api-contract, json, identity-provider |
| could not read from | exception | error | python, sdist, tarfile, packaging |
| Headroom proxy not reachable at | exception | error | proxy, configuration, openclaw |
| mistral-common is required for MistralTokenizer. Install… | exception | error | tokenizer, mistral, dependencies, optional-import |
| save_path must be provided when auto_save is True | validation | error | validation, configuration, vector-index, persistence, memory |
| any-llm-sdk is required for AnyLLMBackend. Install with… | exception | error | python, import, optional-dependency, pip, backend |
bedrock_eventstream_parse_failed implausible prelude lengths: total_length= | exception | error | configuration, memory, startup, validation |
| declares License-File entries missing from tarball | exception | error | python, licensing, sdist, packaging |
| Must provide either tokenizer or factory | exception | error | registry, validation, api-misuse |
| expected exactly one | exception | error | python, maturin, wheel, build |
| format_retrieval_miss_detail(store.get_entry_status(hash_key… | http | warning | http, cache, race-condition |
| session_id must be non-empty | validation | error | validation, session, tracker, headers |
| Error: 'copilot' not found in PATH. | console | error | path, installation, github-copilot, cli, headroom |
| proxyUrl must not include a path, query, or hash | validation | error | proxy, url, validation, openclaw |
| declares no License-File entries | exception | error | python, licensing, sdist, maturin, metadata |
| ccr redis backend init failed | exception | error | compression, zstd, corrupt-body, request-body |
| dedup_similarity_threshold must be 0.0-1.0, got | validation | error | python, config, validation, range-check, dedup, memory-bridge |
| invalid upstream URL | http | error | config, url, upstream, http, rust |
| qdrant-client not installed. Install with: pip install… | exception | error | python, import, dependency, qdrant, mem0, memory-backend |
| Error: 'claude' not found in PATH. | console | error | path, installation, claude-code, cli, headroom |
| failed to download ` ` from HuggingFace Hub | exception | error | compression, brotli, dependency, request-body |
| OpenAI API key required. Provide api_key parameter or set… | validation | error | configuration, auth, api-key, embeddings, memory |
| : no prebuilt binary for ; supported | exception | error | python, binaries, platform, architecture, platform-not-supported |
| compression engine startup failed | error_code | critical | startup, compression, assets, config, rust |
| default_importance must be 0.0-1.0, got | validation | error | python, config, validation, range-check, importance, memory-bridge |
| metrics response build error | http | warning | prometheus, metrics, http, unreachable, rust |
| Timed out waiting for DirectMem0 background writes | exception | error | python, asyncio, timeout, shutdown, background-tasks, mem0 |
| vector_dimension must be positive, got | validation | error | python, config, validation, vector, embeddings, range-check |
| expected an integer, got | validation | error | settings, validation, numbers |
| expected one sdist root directory, found | exception | error | python, sdist, packaging, maturin |
| HeadroomSuite requires at least one scenario | exception | error | testing, harness, validation, empty-input |
| openai_api_key is required when using OpenAI embedder… | validation | error | python, config, openai, api-key, embeddings, validation |
| does not support encoding | exception | warning | tokenizer, capability, not-implemented, dependencies |
| target_savings must be between 0 and 1 | validation | error | python, validation, savings, range-check |
| Ollama API failed after | exception | error | ollama, retry, network, embeddings, local-model |
| should contain exactly one dist-info/METADATA, found | exception | error | python, wheel, packaging, metadata |
| EmbeddingScorer requires sentence-transformers. Install… | exception | error | dependencies, optional-feature, relevance, installation |
| format_retrieval_miss_detail(entry_status) | http | warning | http, cache, retrieval |
| Error: 'vibe' not found in PATH. | console | error | path, installation, vibe, mistral, cli, headroom |
| invalid rollout worker unsafe override | exception | error | serialization, rollout, type-validation, boolean |
| Unsupported bump level | exception | error | versioning, release, validation |
| duplicate scenario name in suite | exception | error | testing, harness, duplicates, config |
| rate_limit_requests_per_minute must be >= 1 when… | validation | error | config, validation, rate-limit |
| retry_max_attempts must be >= 1 when retry_enabled=True | validation | error | config, validation, retries |
bedrock_eventstream_crc_mismatch prelude CRC mismatch: expected= | exception | error | configuration, environment-variables, memory, startup |
| invalid rollout worker field | exception | error | serialization, rollout, type-validation, lists |
| magika inference failed | exception | error | compression, content-encoding, request-body, headers |
| ScenarioOrchestrator requires at least one scenario | exception | error | testing, validation, empty-input, orchestrator |
| invalid pipeline config TOML | exception | error | json, validation, request-body |
| doc_json must be JSON | panic | error | python, json, pyo3, ffi, validation |
| Invalid memory_mode= | validation | error | config, enum, validation |
| Invalid release tag | exception | error | versioning, release, validation, git |
bedrock_sigv4_failed sigv4 signing failed | http | error | bedrock, sigv4, auth, aws, rust |
| hnsw_ef_search must be positive, got | validation | error | python, config, validation, hnsw, vector-index, range-check |
| HNSW index not found | exception | error | hnsw, persistence, file-not-found, load |
| Invalid tool call or not a | http | error | http, validation, tool-call |
| must be <= | validation | error | settings, validation, range |
| auth_style must be 'post' or 'basic' | validation | error | oauth2, validation, configuration, env-vars |
| metadata ( ) must match memory_ids ( ) length | validation | error | validation, batch, fts5, memory, invariant |
| Saved index dimension | validation | error | hnsw, dimension-mismatch, persistence, load |
| Unknown scorer tier: . Valid tiers | exception | error | validation, arguments, relevance |
| cache_max_size must be positive, got | validation | error | python, config, validation, cache, range-check |
| invalid rollout worker snapshot | exception | error | serialization, rollout, validation, worker-handoff |
| memory_ids ( ) and texts ( ) must have same length | validation | error | validation, batch, fts5, memory, invariant |
| openai is required for OpenAIEmbedder. Install it with: pip… | exception | error | dependencies, import, embeddings, memory, optional-extra |
| proxyPort must be an integer between 1 and 65535 | validation | error | proxy, configuration, validation, openclaw |
| Memory has no embedding | validation | error | hnsw, embedding, validation, vector-index |
| hnsw_m must be positive, got | validation | error | python, config, validation, hnsw, vector-index, range-check |
| FastAPI required. Install: pip install fastapi uvicorn httpx | exception | error | dependencies, import, server |
| jinja2 is required for report generation. Install with: pip… | exception | error | dependencies, optional-feature, jinja2, reporting, lazy-import |
| EmbeddingScorer requires fastembed. Install with: pip… | exception | error | dependencies, optional-feature, fastembed, lazy-import |
| does not support decoding | exception | warning | tokenizer, capability, not-implemented, dependencies |
| unsupported rollout worker schema version | exception | error | versioning, serialization, rollout, worker-handoff |
| upstream request failed | http | error | network, upstream, http, timeout, rust |
| Cannot update memories belonging to other users | exception | error | python, mem0, authorization, ownership, multi-tenant, validation |
| Embedding dimension does not match index dimension | validation | error | hnsw, dimension-mismatch, embedding, validation |
| Invalid proxyUrl | validation | error | proxy, url, validation, openclaw |
| query_text provided but HNSWVectorIndex does not embed… | validation | error | hnsw, search, query-text, validation |