Skip to content

Start from the symptom

17 symptom-led guides: what you see, the likely causes, what to check first, and a bounded fix.

Getting started

Hermes Agent install or update failedSymptom-led fixes for a Hermes install script that errors out, a missing hermes command, Python or permission problems, and updates that leave things half-done.

Memory & context

Hermes Agent memory not carrying over between sessionsCheck the actual write, profile and session boundary before adding more reminders to the prompt.Hermes Agent ignoring your project instructionsVerify the active directory, chosen context file and loading evidence before rewriting the rules.Hermes Agent forgets things mid-conversationWhy a long Hermes session can lose earlier details after context compression, and how to keep the important parts in view.

Skills, plugins & MCP

Hermes Agent MCP tool missing or failingSeparate discovery, connection, authentication and operation failures using one known read-only request.Hermes Agent not using your skillWhat to check when Hermes ignores a skill you wrote or installed, from file location and frontmatter to platform filters, trust and session timing.

Models, providers & cost

Hermes Agent still using the wrong modelCompare effective settings with the running process before editing keys repeatedly.Hermes Agent rate limits and provider errorsHow to read 429s, quota errors, auth failures and stream errors from your model provider, and how retries, credential pools and fallback providers can keep Hermes working.Hermes Agent local model won't start or goes silentFix the context-window and tool-calling mismatches behind most local model failures with Ollama, llama.cpp, vLLM and LM Studio.Hermes Agent OAuth login stuck or expiredDiagnose expired or revoked subscription logins, MCP OAuth that never returns, and logins that worked but landed in the wrong Hermes home.

Automation & scheduling

Hermes Agent scheduled job didn't runSeparate a stopped scheduler, an unwritable store and a failed job before recreating the schedule.Hermes Agent stuck in a tool loopHow to stop a Hermes turn that keeps calling tools or seems frozen, and the documented limits and settings that prevent it happening again.

Messaging & the gateway

Hermes Agent task finished but no message arrivedThe task ran but no message arrived? Check the saved result and intended destination before you run the whole task again.Hermes Agent bot not responding in your chat appWhat to check when your Hermes bot on Telegram, Discord or another chat app stays silent, replies 'unauthorized', or works in DMs but not in groups.

Security & permissions

Hermes Agent task denied when scheduledFind the blocked operation and execution policy instead of disabling approvals for every unattended task.

Running & deploying

Hermes Agent terminal can't find files or programsCheck where the command actually runs, then verify paths and dependencies inside that environment.Hermes Agent on Windows: command not found and other fixesWork through the documented Windows pitfalls for native installs and WSL2, from PATH and encoding to editors, shell scripts and the login-time gateway task.