Hermes Agent
How-to hub

Hermes Agent setup guides for self-hosting and operations

If your intent is practical — install, connect, deploy, schedule, or migrate — this is the section to use. Start with the fastest install path, then branch into the exact integration or infrastructure guide you need.

Browse section

Best pages to start with

Setup guide
How to Install Hermes Agent: CLI, macOS & Docker

Install Hermes Agent with the official CLI: handle macOS quirks, set an API key, run hermes doctor, open the dashboard, or pick FlyHermes cloud.

Setup guide
How to Connect Telegram to Hermes Agent

Step-by-step Hermes Telegram setup: BotFather token, human user ID, pairing, gateway restart, DM proof, groups/topics, and FlyHermes hosted path.

Setup guide
Connect Hermes Agent to Discord (2026): Bot & Permissions

Connect Hermes Agent to Discord with bot intents, fail-closed users/roles/channels, thread sessions, gateway setup, provider smoke tests, and one real reply.

Setup guide
How to Set Up Hermes Agent Memory (Built-In + Providers)

Configure Hermes Agent built-in memory, review MEMORY.md and USER.md, choose an optional external memory provider, and separate durable facts from session history.

Setup guide
How to Create a Hermes Agent Skill: SKILL.md, Triggers, and Tests

Create a focused Hermes Agent skill with valid SKILL.md frontmatter, narrow triggers, supporting references or scripts, safety boundaries, and a repeatable acceptance test.

Setup guide
How to Schedule Hermes Agent Cron Jobs

Create and verify Hermes Agent cron jobs with fresh-session prompts, workdir, script-only mode, provider safeguards, exact delivery, and recovery commands.

Setup guide
How to Deploy Hermes Agent on a VPS

Deploy Hermes Agent on a VPS, understand the hidden maintenance cost, and decide when FlyHermes is easier for gateways, memory, and agents.

Setup guide
How to Connect WhatsApp to Hermes Agent (Baileys or Cloud API)

Set up Hermes Agent on WhatsApp with the Baileys QR bridge or Meta's official Cloud API, including allowlists, sessions, webhooks, voice notes, cron limits, and troubleshooting.

Setup guide
Hermes Slack Setup: Socket Mode, Tokens & Channel Tests

Connect Hermes Agent to Slack with the generated app manifest, Socket Mode tokens, user and channel allowlists, thread commands, cron delivery, and exact troubleshooting checks.

Setup guide
Hermes Agent Ollama Setup: Run a Local LLM

Connect Hermes Agent to Ollama with the current quick launch or manual OpenAI-compatible endpoint, then verify context, tool calls, privacy, and fallbacks.

Setup guide
How to Use Hermes Agent with OpenRouter

Set up Hermes Agent with OpenRouter, choose models, control credits and spend, configure fallbacks, and troubleshoot rate limits or model switching.

Setup guide
How to Use the Hermes Agent CLI

Master the Hermes CLI for managing your agent, skills, memory, and configuration from the terminal.

Setup guide
How to Update Hermes Agent Safely (CLI, Desktop, Docker)

Update Hermes Agent safely with current backup, preview, dependency, Desktop, Docker, Windows, gateway, and post-update verification steps.

Setup guide
How to Back Up and Restore Hermes Agent

Back up and restore Hermes Agent memory, profiles, sessions, skills, cron jobs, config, and credentials with the current Hermes CLI.

Setup guide
How to Set Up Multiple Hermes Agents

Run multiple Hermes agents with different personalities, skills, and channels — each with isolated memory.

Setup guide
How to Secure Your Hermes Agent Server

Harden your Hermes Agent deployment with firewall rules, SSH keys, approval workflows, and best practices.

Setup guide
How to Use Hermes Tirith Security Approvals

Set up Tirith approval workflows so Hermes asks permission before running dangerous or sensitive commands.

Setup guide
How to Migrate from OpenClaw to Hermes Agent Safely

Use hermes claw migrate to preview and import OpenClaw memory, skills, providers, MCP servers, channels, and settings, then verify archived items and secrets safely.

Setup guide
Hermes Agent Docker Compose Setup: Official Image, Volumes & Dashboard

Run Hermes Agent with the official Docker image, persistent /opt/data storage, supervised gateways, private dashboard access, logs, and safe updates.

Setup guide
How to Install Hermes Agent with Pinokio

Install Hermes Agent in one click using Pinokio — no terminal, no config files, just click and go.

Setup guide
How to Add Custom Tools to Hermes Agent

Extend Hermes Agent with custom tools — shell scripts, APIs, MCP servers, and external integrations.

Setup guide
How to Use Hermes Agent Voice Mode

Enable voice input and output for Hermes Agent — talk to your AI and hear responses spoken back.

Setup guide
How to Run Hermes Agent Fully Offline

Run Hermes Agent completely offline with local models, local STT, and zero internet dependency.

Setup guide
Hermes Desktop Install Troubleshooting on Windows

Fix Hermes Desktop installation on Windows: PATH, enterprise npm proxy, missing dependencies, endless loading, provider setup, native Windows limits, and WSL2 choices.

Setup guide
How to Open and Secure the Hermes Agent Dashboard

Open Hermes Web UI on port 9119, keep it running with systemd on Linux, secure remote access, use browser Chat, and verify channels and cron jobs end to end.

Setup guide
How to Use Hermes Agent with GitHub Repositories

Connect Hermes Agent to GitHub repositories for issue triage, PR reviews, Actions troubleshooting, code search, and repo management.

Setup guide
How to Share Memories Across Multiple Hermes Instances

Sync memory, skills, and config across multiple Hermes Agent installations using backup, import, and sync tools.

Setup guide
How to Fix Hermes Agent Not Using Tools

Troubleshoot when Hermes acts like a basic chatbot instead of an agent — not executing tools, commands, or actions.

Setup guide
How to Use Hermes Agent with Google Gemini

Connect Hermes Agent to Google Gemini models using Code Assist API OAuth, including 1M token context and multi-tool support.

Setup guide
How to Connect Hermes Agent to Email

Connect Hermes Agent to your email for AI-powered inbox management, auto-replies, and smart filtering.

Setup guide
How to Fix Hermes Docker Container Issues with Discord

Resolve issues when Hermes running via Discord suddenly appears inside a Docker container, losing access to config files and volumes.

Setup guide
How to Fix Copilot-ACP Issues in Hermes

Resolve common Copilot-ACP authentication and model errors when using GitHub Copilot as a provider in Hermes Agent.

Setup guide
How to Fix API Key Paste Issues in Hermes

Resolve issues where API keys won't paste during Hermes setup on WSL, Termux, or non-standard terminals.

Setup guide
How to Fix White Block Emojis in Matrix

Resolve the white square emoji rendering issues that appear in Matrix/Element when using Hermes Agent.

Setup guide
How to Run Hermes Commands in Docker Containers

Configure Hermes Agent to execute terminal commands inside isolated Docker containers for security and reproducibility.

Setup guide
How to Run Hermes Commands on a Remote Server via SSH

Configure Hermes Agent to execute commands on a remote server while keeping the agent code local — perfect for sandboxing.

Setup guide
How to Run Hermes on Modal Cloud (Serverless)

Configure Hermes Agent to execute commands on Modal's serverless cloud infrastructure — GPU access, auto-scaling, pay only when active.

Setup guide
How to Run Hermes in Daytona Cloud Workspaces

Configure Hermes Agent to execute commands in Daytona's managed cloud development environments — persistent workspaces with team collaboration.

Setup guide
How to Run Hermes in Singularity/Apptainer Containers (HPC)

Configure Hermes Agent to execute commands in Singularity containers — ideal for HPC clusters and shared compute environments.

Setup guide
How to Configure Hermes Context Compression

Inspect Hermes context with /context, configure in-place compression, and recover long conversations without confusing context pressure with memory loss.

Setup guide
How to Connect MCP Servers to Hermes Agent Safely (2026)

Connect local, Docker, and OAuth MCP servers to Hermes Agent safely. Fix mcp_servers YAML, container paths, remote auth, stale tools, and gateway reloads.

Setup guide
How to Set Up Hermes Voice Mode (Speech-to-Text & TTS)

Enable voice interaction with Hermes — speak your commands, hear the responses with text-to-speech.

Setup guide
Hermes Browser Automation Setup: Browser Use, Cloud & Local Chrome

Configure Browser Use mode, browser_exec sessions, Lightpanda, Browserbase, Firecrawl, Camofox, or local Chrome CDP, then verify screenshots and console evidence.

Setup guide
How to Configure Hermes Subagent Delegation

Set up subagent spawning so Hermes can delegate tasks to child agents for parallel workstreams and complex orchestration.

Setup guide
How to Set Up Hermes Shell Hooks

Register shell scripts as callbacks for Hermes events — block dangerous commands, auto-format files, inject context, and log activity.

Setup guide
How to Configure Hermes Session Reset Policies

Control when messaging sessions automatically reset — balance context length, API costs, and conversation continuity.

Setup guide
How to Customize Hermes CLI Appearance (Skins)

Change Hermes CLI colors, spinner animations, branding, and response styling with built-in or custom skins.

Setup guide
How to Configure Hermes Reasoning Effort Levels

Control how much 'thinking' the model does before responding — balance speed, cost, and reasoning depth.

Setup guide
How to Use Hermes with Google Gemini

Configure Hermes Agent to use Google's Gemini models directly via Google AI Studio — fast, capable, and cost-effective.

Setup guide
How to Use Hermes with Ollama (Local Models)

Configure Hermes Agent with Ollama’s local OpenAI-compatible endpoint, exact model discovery, context checks, and tool-call troubleshooting.

Setup guide
How to Use Hermes with MiniMax

Configure Hermes Agent to use MiniMax models — powerful Chinese AI models with excellent reasoning capabilities.

Setup guide
How to Use Hermes with Kimi/Moonshot

Configure Hermes Agent to use Kimi Code models from Moonshot AI — excellent for coding tasks.

Setup guide
How to Use Hermes with z.ai/GLM

Configure Hermes Agent to use ZhipuAI's GLM models via z.ai — powerful Chinese language models.

Setup guide
How to Use Hermes with Hugging Face Inference

Configure Hermes Agent to use 20+ open models via Hugging Face's unified inference endpoint.

Setup guide
How to Use Hermes with NVIDIA NIM

Configure Hermes Agent to use NVIDIA NIM for optimized inference on NVIDIA hardware.

Setup guide
How to Use Hermes with GitHub Copilot

Configure Hermes Agent to use GitHub Copilot models via your existing Copilot subscription.

Setup guide
How to Use Hermes with Xiaomi MiMo

Configure Hermes Agent to use Xiaomi's MiMo models — excellent for auxiliary tasks and reasoning.

Setup guide
How to Use Hermes with Arcee AI

Configure Hermes Agent to use Arcee AI's Trinity models — specialized models for enterprise tasks.

Setup guide
Hermes Desktop Won't Open After Update: Windows, macOS & Linux Fixes

Recover Hermes Desktop when it will not launch after an update without deleting profiles, memory, sessions, skills, or credentials.