NousResearch/hermes-agent
Documented errors, page 2 of 6. Back to NousResearch/hermes-agent
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| management reload failed | exception | error | api, daemon, http, iron-proxy |
| Anthropic Messages adapter requires a positive max_tokens… | validation | error | anthropic, max-tokens, validation, adapter |
| openssl not found on PATH. Install OpenSSL (apt: `openssl`… | exception | error | dependencies, certificates, openssl, iron-proxy |
| Desktop installation ID path is not a regular file. | exception | error | cron, one-shot, update, schedule |
| Invalid cron job id for output path | validation | error | cron, security, path-traversal, validation |
| Provider ' ' is set in config.yaml but no API key was… | exception | error | auxiliary, credentials, configuration, env |
| HERMES_DESKTOP_REMOTE_URL is set but… | exception | error | environment, remote, gateway, token, config, desktop |
| iron-proxy rejected the new config (validation failed; the… | exception | error | config, validation, daemon, iron-proxy |
| Invalid PDF file header | validation | warning | desktop, preview, pdf, magic-bytes, validation |
| Anthropic token refresh failed | exception | error | oauth, anthropic, token-refresh, auth |
| failed: exit \n | exception | critical | cron, json, corruption, runtimeerror |
| session not found when storing title | exception | error | sessions, title-generation, sqlite, session-store |
| waiting for child | exception | error | child-process, update, os-signal, bootstrap-installer |
| Invalid PDF data URL type | validation | warning | desktop, preview, pdf, data-url, mime-type |
| iron-proxy is not running — nothing to reload. Run `hermes… | exception | warning | lifecycle, daemon, iron-proxy |
| memory node id is stale — refresh the graph | exception | error | memory, learning-graph, stale-state |
| OAuth authorization failed | exception | error | oauth, mcp, polling |
| default export must be register(sdk) | exception | error | widgets, dynamic-import, es-modules, dashboard |
| Malformed custom endpoint URL | exception | error | config, base-url, validation, http |
| Stored token set missing accessToken | validation | error | auth, oauth, token-storage, desktop |
| billing.charge_status returned no response | exception | error | tui, billing, topup, gateway-rpc, version-skew |
| Cron expressions require 'croniter' package. Install with… | exception | error | cron, dependencies, croniter, scheduling |
| path is a sensitive credential file and cannot be attached | exception | error | security, credentials, references, path-validation |
| Theme has no "colors" map — not a VS Code color theme. | exception | error | desktop, themes, vscode, conversion |
| content required | validation | error | acp, editor-integration, validation, tool-schema, python |
| codex app-server stdin closed unexpectedly | exception | error | subprocess, codex, broken-pipe, crash |
| Image at exceeds MB cap; refusing to cache. | exception | warning | image-gen, download, size-limit, caching |
| spawning | exception | error | child-process, spawn, update, bootstrap-installer |
| codex app-server method | exception | error | jsonrpc, codex, timeout, subprocess |
| Invalid data URL | validation | error | url, data-url, validation, image, desktop |
| Another iron-proxy start appears to be in progress | exception | error | egress-proxy, concurrency, pidfile |
| boto3 does not support converse_stream (minimum 1.34.59… | exception | error | bedrock, aws, version, dependencies |
| Secure token storage is unavailable (no OS keyring service… | exception | error | desktop, keyring, safe-storage, linux, secrets, electron |
| Session token not available — page must be served by the… | exception | critical | websocket, auth, spa, bootstrap |
| Trace upload blocked: secret redaction failed, so the… | exception | error | security, redaction, trace-upload, fail-closed |
| Your remote gateway session has expired. Open Settings ->… | exception | error | oauth, websocket, auth-expiry, gateway, shared |
| Model has a context window of tokens, which is below the… | validation | error | config, model, context-window, validation |
| ${res.status}: ${text || res.statusText} | http | error | cron, naming, lookup, ambiguity |
| hermes-tools MCP server requires the 'mcp' package | exception | error | mcp, dependency, import, optional-extra |
| Termux:API command package detected, but the Android app is… | exception | error | voice, termux, android, dependencies |
| Codex auxiliary Responses stream did not return a final… | exception | error | codex, streaming, auxiliary, responses-api |
| Failed to download : HTTP from | exception | error | network, http, bootstrap-installer, github |
| Invalid rename | validation | warning | validation, filesystem, ipc, desktop, rename |
| text || HTTP | http | error | http, upload, image, dashboard |
| Copilot ACP process did not expose stdin/stdout pipes. | exception | error | copilot, acp, stdio, process |
| No checksum entry for | exception | error | release-assets, install, iron-proxy |
| Remote gateway URL must be http:// or https://, got | validation | error | cron, monitor, no-agent, validation |
| PyYAML is required to write the iron-proxy config but is… | exception | error | dependencies, python, config, iron-proxy |
| Could not start Copilot ACP command | exception | error | copilot, acp, startup, environment |
| Hermes backend did not become ready | exception | critical | cron, ioerror, filesystem, permissions, runtimeerror |
| Per-launch timeout is not supported; configure delegation… | exception | error | subagents, delegation, validation, timeout |
| The 'azure-identity' package is required for Azure AI… | exception | error | azure, entra-id, dependency-install, offline |
| could not reach the management API at | exception | error | network, daemon, migration, iron-proxy |
| Failed to encrypt the remote gateway token for secure… | exception | error | desktop, keyring, safe-storage, encryption, electron, secrets |
| Marketplace install is only available in the desktop app. | exception | error | desktop, themes, preload-api, environment |
| Non-streaming API call timed out after | exception | error | non-streaming, timeout, retry, stale |
| Unknown skill(s) | validation | error | skills, cli, kanban, configuration |
| Write denied: ' ' requires interactive approval and cannot… | exception | error | copilot, acp, security, write-protection |
| Bitwarden refresh did not return secrets for | exception | error | bitwarden, secrets, egress-proxy, configuration |
| Rebuilding the desktop app failed | exception | error | build, desktop, update, bootstrap-installer |
| iron-proxy exited immediately | exception | error | egress-proxy, startup, configuration |
| This Desktop build cannot refresh OAuth WebSocket tickets… | exception | error | desktop, oauth, websocket, version-skew, shared |
| Could not find the hermes CLI under | exception | error | filesystem, update, venv, bootstrap-installer |
| Invalid path | validation | warning | validation, filesystem, ipc, desktop |
| management.token is missing — re-run `hermes egress setup`… | exception | warning | config, auth, daemon, iron-proxy |
| Remote path must be absolute or start with ~/ | validation | error | validation, remote, path |
| Hermes install at is missing or incomplete. Reinstall via… | exception | critical | desktop, install, runtime, bootstrap, startup |
| Expected exported session JSON or JSONL | validation | error | import, json, sessions, validation |
gemini_invalid_json Invalid JSON from Gemini native API | exception | error | gemini, json, http, proxy |
| " " does not contribute any color themes. | exception | error | desktop, themes, vscode, marketplace |
| ACP file-system paths must be absolute. | exception | error | acp, copilot, path-validation, protocol |
| Desktop installation ID is invalid. | validation | error | cron, notepad, validation, valueerror |
| gateway not connected | exception | error | tui, gateway, websocket, connection, retry |
| Hermes is still running. Close all Hermes windows and try… | exception | error | update, process-lifecycle, bootstrap-installer |
| management API rejected our key (401). The running daemon… | exception | warning | auth, daemon, config, iron-proxy |
| Cannot resolve : no SOURCE_REPO_ROOT and no install stamp… | exception | critical | cron, json, corruption, runtimeerror |
| Cron job ' ' has no model configured (job.model= … | exception | error | |
| Skipped to prevent unintended spend: global inference… | exception | error | |
| produced no parseable JSON payload\n | exception | error | cron, workdir, paths, validation |
| failed to spawn iron-proxy | exception | error | subprocess, egress-proxy, installation |
| First-run remote setup completed without a saved remote… | exception | error | desktop, first-run, remote-backend, invariant |
| iron-proxy did not bind | exception | error | egress-proxy, network, startup, timeout |
| /api/auth/ws-ticket: HTTP | http | error | websocket, auth, ticket, dashboard |
| codex app-server stdin not available | exception | error | subprocess, codex, jsonrpc, spawn-config |
| An update is already in progress. | exception | warning | desktop, update, concurrency, guard, electron |
| Delete is not available | exception | error | desktop, electron, filesystem, delete, capability |
| Could not generate a valid desktop installation ID. | exception | error | cron, schedule, one-shot, update, clock |
| Could not refresh the remote gateway WebSocket ticket. | exception | error | oauth, websocket, gateway, shared, retry |
| Path ' ' is outside the session cwd ' '. | exception | error | acp, copilot, security, workspace |
| refusing to install update into non-app path | exception | error | macos, validation, update, bootstrap-installer |
| Could not read image | exception | error | image, electron, native-image, clipboard, codec |
| The 'anthropic' package is required for Azure Foundry… | exception | error | anthropic, azure, entra-id, dependency |
| Malformed proxy environment variable | exception | error | proxy, environment, validation, http |
| Unknown uninstall mode | validation | error | cron, notepad, validation, valueerror |
| Unsupported Hermes backend URL protocol | validation | error | cron, no-agent, script, validation |
| blueprint prompt missing value for | validation | error | cron, blueprint, template, developer-error |
| no install root | exception | error | cron, schedule, validation, valueerror |
| Refusing to write pidfile | exception | error | security, filesystem, egress-proxy, pidfile |
| Remote Hermes gateway is selected, but no session token is… | exception | error | gateway, remote, token, auth, connection, desktop |
| Video at exceeds MB cap; refusing to cache. | validation | warning | video, download, size-limit, cache |