{"slug":"hermes-agent","name":"Hermes Agent","kind":"runbook","what":"Nous Research's self-improving agent: skills, cross-session memory and a messaging gateway, pointed at your local model.","page":"https://insidethemachine.ai/setups/hermes-agent","status":"docs-checked","status_label":"Not run: commands checked against the official docs only","status_note":"Commands checked against the official docs on 2026-10-15. Not run end to end.","wrapper":"The wrapper scripts are generated from the site data. Every .sh passed bash -n and shellcheck and ran in plan mode on Linux (Debian 13). Every .ps1 passed the PowerShell parser and chat.ps1 ran in plan, verify and rollback mode under PowerShell 7 on Linux with Windows calls mocked. Not run on macOS or real Windows.","wrapper_tested":null,"sh":"https://insidethemachine.ai/install/hermes-agent.sh","ps1":"https://insidethemachine.ai/install/hermes-agent.ps1","md":"https://insidethemachine.ai/install/hermes-agent.md","json":"https://insidethemachine.ai/install/hermes-agent.json","one_liner":"curl -fsSL https://insidethemachine.ai/install/hermes-agent.sh | bash","one_liner_windows":"irm https://insidethemachine.ai/install/hermes-agent.ps1 | iex","actions":{"install":"curl -fsSL https://insidethemachine.ai/install/hermes-agent.sh | bash","plan":"curl -fsSL https://insidethemachine.ai/install/hermes-agent.sh | bash -s -- plan","verify":"curl -fsSL https://insidethemachine.ai/install/hermes-agent.sh | bash -s -- verify","rollback":"curl -fsSL https://insidethemachine.ai/install/hermes-agent.sh | bash -s -- rollback --yes"},"env":{"ITM_RAM":"memory in GB instead of detecting it"},"model_by_memory_gb":null,"low_memory":null,"platforms":{"macos":{"install":[{"title":"Install Hermes Agent","lines":[{"k":"run","c":"curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash"},{"k":"you","c":"source ~/.zshrc","why":"open a new Terminal window instead"}]},{"title":"Configure (your choices)","lines":[{"k":"you","c":"ollama launch hermes","why":"easiest path: Ollama installs Hermes if needed, points it at http://127.0.0.1:11434/v1 and sets your model as primary"},{"k":"you","c":"hermes model","why":"manual path: choose More providers → Custom endpoint → http://127.0.0.1:11434/v1, leave API key blank"},{"k":"you","c":"OLLAMA_CONTEXT_LENGTH=64000 ollama serve","why":"Ollama docs: agents need at least 64000 tokens of context"},{"k":"you","c":"hermes gateway setup","why":"optional: chat with it from Telegram/Discord/Slack/WhatsApp/Signal/Email"}]}],"verify":[{"run":"hermes doctor","expect":"diagnostics report with no blocking errors"},{"run":"hermes","expect":"TUI opens; a one-line prompt gets an answer from the local model","you":true}],"rollback":[{"k":"run","c":"hermes uninstall --dry-run"},{"k":"run","c":"hermes uninstall"}]},"linux":{"install":[{"title":"Install Hermes Agent","lines":[{"k":"run","c":"curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash"},{"k":"note","c":"Open a new Terminal window (or run: source ~/.bashrc)"}]},{"title":"Configure (your choices)","lines":[{"k":"you","c":"ollama launch hermes","why":"easiest path: Ollama installs Hermes if needed, points it at http://127.0.0.1:11434/v1 and sets your model as primary"},{"k":"you","c":"hermes model","why":"manual path: choose More providers → Custom endpoint → http://127.0.0.1:11434/v1, leave API key blank"},{"k":"you","c":"OLLAMA_CONTEXT_LENGTH=64000 ollama serve","why":"Ollama docs: agents need at least 64000 tokens of context"},{"k":"you","c":"hermes gateway setup","why":"optional: chat with it from Telegram/Discord/Slack/WhatsApp/Signal/Email"}]}],"verify":[{"run":"hermes doctor","expect":"diagnostics report with no blocking errors"},{"run":"hermes","expect":"TUI opens; a one-line prompt gets an answer from the local model","you":true}],"rollback":[{"k":"run","c":"hermes uninstall --dry-run"},{"k":"run","c":"hermes uninstall"}]},"windows":{"install":[{"title":"Install Hermes Agent","lines":[{"k":"run","c":"iex (irm https://hermes-agent.nousresearch.com/install.ps1)"}]}],"verify":[{"run":"hermes doctor","expect":"diagnostics report with no blocking errors"},{"run":"hermes","expect":"TUI opens; a one-line prompt gets an answer from the local model","you":true}],"rollback":[{"k":"run","c":"hermes uninstall --dry-run"},{"k":"run","c":"hermes uninstall"}]}}}