NousResearch/hermes-agent
Documented errors, page 3 of 6. Back to NousResearch/hermes-agent
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Gemini native client requires an API key, but none was… | exception | error | gemini, api-key, config, authentication |
| token provider returned empty value | validation | error | azure, entra-id, authentication, token |
| Voice mode requires sounddevice and numpy. Install with | exception | error | voice, audio, python, dependencies |
| Branch name is required. | validation | error | git, worktree, branch, validation, desktop, ipc |
| launching | exception | warning | macos, launch, gatekeeper, update, bootstrap-installer |
| unexpected EOF while reading LSP headers | exception | error | lsp, protocol, subprocess, eof |
| Copilot ACP failed | exception | error | copilot, acp, jsonrpc, protocol |
| register_provider() expects a TranscriptionProvider… | exception | error | typing, plugin, stt, registry, validation |
| Transcription provider .name must be a non-empty string | exception | error | validation, plugin, stt, registry |
| bad memory node id | exception | error | memory, learning-graph, validation |
| Blocked: cron job contains a gateway lifecycle command or… | exception | error | |
| installing updated app at | exception | error | macos, filesystem, atomic-swap, update, bootstrap-installer |
| Malformed subagent handle. | exception | error | subagents, delegation, serialization, dataclass |
| No LLM provider configured for task= | exception | error | vision, auxiliary, configuration, credentials |
| Timed out connecting to Hermes backend after | exception | error | cron, schedule, one-shot, clock, validation |
| tool args must be a mapping, got | exception | error | tools, guardrails, validation, json |
| cannot read | exception | error | lsp, filesystem, validation |
| codex app-server error | exception | error | jsonrpc, codex, protocol-error |
| Not a directory | validation | error | fs-watch, plugins, filesystem, validation, desktop |
| The 'anthropic' package is required for the Anthropic… | exception | error | anthropic, dependency, provider, import |
| Image at returned 0 bytes; refusing to cache. | exception | error | image-generation, network, cache, validation |
| exited and is served by a process we did not spawn… | exception | error | cron, immutability, security, validation |
| OAuth server did not provide an authorization URL | exception | error | oauth, mcp, api-contract |
| Theme file is not a JSON object. | exception | error | desktop, themes, vscode, json-parse |
| Unsafe remote path: contains NUL or newline. | validation | error | security, command-injection, validation, remote |
| Codex auxiliary Responses stream exceeded | exception | error | timeout, codex, streaming, auxiliary |
| Hermes gateway unavailable | exception | error | desktop, wake-word, gateway, connection |
| httpx is required for Entra ID bearer auth on Microsoft… | exception | error | azure, httpx, dependencies, import |
| Image file not found | validation | error | cli, path, image, attachment |
| OAuth failed to start | exception | error | oauth, mcp, backend |
| no install-script pin supplied — installer cannot resolve a… | exception | error | build-config, pinning, bootstrap-installer, git |
| pidfile has unexpected owner uid= | exception | error | filesystem, permissions, egress-proxy, pidfile, nfs |
| Rename is not available | exception | error | desktop, electron, filesystem, rename, capability |
| " " collides with a built-in theme. | exception | error | desktop, themes, naming, validation |
| Extension " " was not found on the Marketplace. | exception | error | marketplace, vscode, extension, network |
| Remote gateway URL is required. | validation | error | cron, workdir, paths, validation |
| Extension " " has no published versions. | exception | error | marketplace, vscode, extension, transient |
| install script pin commit | exception | error | git, pinning, bootstrap-installer, build-config |
| iron-proxy binary not available — run `hermes egress… | exception | error | install, lifecycle, iron-proxy |
| metadata must be JSON-serializable. | exception | error | subagents, delegation, validation, json, metadata |
| Theme is missing required colors. | exception | error | desktop, themes, validation, colors |
| anthropic.AnthropicBedrock not available. Upgrade with: pip… | exception | error | anthropic, bedrock, version, dependency |
| Invalid cron expression | validation | warning | cron, cron-expression, validation, parsing |
| No active Hermes parent session is available. | exception | error | subagents, delegation, session, lifecycle |
| Remote connection is not ready yet. Try again in a moment. | exception | error | cron, workdir, paths, validation |
| Requested toolsets would broaden parent permissions. | exception | error | subagents, delegation, security, privilege-escalation, toolsets |
| Voice mode requires either Termux:API microphone access or… | exception | error | voice, termux, audio, dependencies |
| Invalid profile name | validation | error | profiles, validation, config, desktop |
| Unsafe SSH control dir | exception | error | ssh, security, permissions, filesystem |
| File is empty | validation | warning | import, file, sessions, validation |
| unreasonable Content-Length | exception | error | lsp, protocol, framing, sanity-check |
| Bundle already exists at | exception | error | skills, bundles, filesystem, file-exists |
| management API returned unexpected status | exception | error | api, daemon, version-skew, iron-proxy |
| No valid entries found in dataset file | validation | error | batch, dataset, jsonl, schema |
| Provider ' ' is set in config.yaml but no API key was… | exception | critical | config, provider, api-key, initialization |
| gateway not running | exception | error | tui, gateway, websocket, connection, startup-race |
| OAuth popup was blocked — allow popups for this dashboard… | exception | error | oauth, popup, browser, mcp |
| working_directory is not supported because Hermes delegates… | exception | error | subagents, delegation, validation, working-directory |
| Copilot ACP process exited early | exception | error | copilot, acp, crash, process |
| goal must be a non-empty string of at most 16000 characters. | exception | error | subagents, delegation, validation, input |
| invalid interval — minutes as a positive integer | validation | warning | cron, blueprint, validation, interval |
| unknown slot : — valid | validation | warning | cron, blueprint, validation, typo |
| desktop rebuild succeeded but no Hermes.app was found under | exception | error | macos, build, update, filesystem, bootstrap-installer |
| hermes update failed | exception | error | update, logging, child-process, bootstrap-installer |
| at least two poll options are required | validation | error | whatsapp, bridge, poll, validation |
| Failed to download | exception | error | network, download, install, iron-proxy |
| old_string and new_string required | validation | error | acp, editor-integration, validation, patch, python |
| Per-tool blocking is not supported; use allowed_toolsets… | exception | error | subagents, delegation, validation, security |
| The 'claude' CLI is not installed. Install it with: npm… | exception | error | anthropic, oauth, cli, dependency |
| The 'azure-identity' package is required for Azure AI… | exception | error | azure, entra-id, import, dependencies |
| Unsafe SSH control dir | exception | error | ssh, security, filesystem |
| latitude/longitude out of range | validation | error | whatsapp, bridge, location, validation, range |
| Unsafe SSH key path: contains control characters. | exception | error | ssh, security, validation, path |
| running ditto | exception | error | macos, child-process, update, bootstrap-installer |
| cannot send : stdin closed | exception | error | lsp, lifecycle, subprocess |
| Invalid duration: ' '. Use format like '30m', '2h', or '1d | validation | warning | cron, duration, validation, parsing |
| Anthropic refresh response was missing access_token | exception | error | oauth, anthropic, auth, proxy |
| LSP header block exceeded 8 KiB without terminator | exception | error | lsp, protocol, configuration |
| No bundle at | exception | error | skills, bundles, filesystem, not-found |
| Voice mode requires an STT provider for… | exception | error | voice, stt, configuration, api-key |
| Expected a Marketplace id like "publisher.extension". | validation | error | desktop, themes, validation, marketplace |
| ditto failed while copying updated app into | exception | error | macos, filesystem, update, bootstrap-installer |
| Remote path must not be empty. | validation | error | validation, remote, ssh, path |
| SshConnection requires a host. | exception | error | ssh, validation, constructor |
| The 'anthropic' package is required for the Bedrock… | exception | error | anthropic, bedrock, dependency, aws |
| Plugin cannot route through auxiliary task — a plugin may… | validation | error | |
| no usable api_key / token provider | validation | error | azure, validation, authentication, programming-error |
| clipboard image is empty | validation | warning | clipboard, upload, image, browser |
| OAuth authorization window was closed before completion | exception | warning | oauth, mcp, popup, user-action |
| Desktop installation ID is owned by another user. | exception | error | cron, resume, one-shot, schedule |
| Invalid delete | validation | warning | validation, filesystem, ipc, desktop, trash |
| metadata exceeds 8192 bytes. | exception | error | subagents, delegation, validation, metadata, size-limit |
| codex app-server client is closed | exception | error | jsonrpc, codex, lifecycle, use-after-close |
| Unknown toolsets: . | exception | error | subagents, delegation, toolsets, validation |
| Duplicate correlation_id for this parent session. | exception | error | subagents, delegation, idempotency, registry |
| latitude and longitude must be numbers | validation | error | whatsapp, bridge, location, validation |
| memory index out of range | exception | error | memory, learning-graph, stale-state |
| Failed to initialize OpenAI client | exception | critical | initialization, openai, httpx, config |
| malformed LSP header line | exception | error | lsp, protocol, debugging |
| Name required | validation | warning | validation, mcp, form |