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 Telegram setup for Hermes Agent: BotFather token, profile isolation, gateway restart, DM smoke test, groups/topics, and FlyHermes hosted path.

Setup guide
Connect Hermes Agent to Discord: Bot Token, Intents, Gateway Test

Connect Hermes Agent to Discord with a bot token, Message Content Intent, channel allowlists, thread/forum checks, provider smoke tests, Web UI status, and one real reply test.

Setup guide
How to Set Up Hermes Persistent Memory

Configure persistent memory so Hermes remembers your context, preferences, and history across sessions.

Setup guide
How to Create Custom Skills for Hermes Agent

Create custom skills that extend Hermes with new capabilities — from API integrations to complex workflows.

Setup guide
How to Schedule AI Agent Cron Jobs with Hermes Agent

Schedule Hermes Agent cron jobs safely: natural-language schedules, script-only monitors, pinned Telegram/Discord delivery, rate-limit avoidance, dashboard checks, and recovery when a morning brief or publishing job fails.

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

Connect Hermes Agent to WhatsApp for AI assistance through the world's most popular messaging app.

Setup guide
Hermes Slack Setup: Connect Hermes Agent to Slack

Connect Hermes Agent to Slack with app permissions, channel tests, gateway config, troubleshooting checks, and team-safe automation patterns.

Setup guide
How to Use Hermes Agent with Ollama

Run Hermes Agent with local LLMs via Ollama — fully private, no API keys, no cloud dependency.

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

Step-by-step guide to update Hermes Agent safely: pull the latest version, run migrations, restart the gateway, and verify the upgrade on macOS or Linux.

Setup guide
How to Backup and Restore Hermes Agent Memory

Backup your Hermes Agent memory, skills, and config so you never lose your AI's learned context.

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

Migrate your OpenClaw setup to Hermes Agent — transfer memory, skills, config, and channels seamlessly.

Setup guide
Hermes Agent Docker Compose Setup: Volumes, Gateways, Logs

Run Hermes Agent with Docker Compose using persistent volumes, safe environment variables, restart policies, gateway logs, and Discord/Telegram checks.

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
How to Use the Hermes Agent Dashboard & Web UI

Open and use the Hermes Agent dashboard/Web UI as a private AI agent command center for profiles, sessions, analytics, logs, MCP, memory, skills, cron jobs, gateway health, browser Chat, and final delivery proof.

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

Set up automatic context compression so Hermes can handle long conversations without running out of context window.

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

Connect MCP servers to Hermes Agent safely with the catalog, tool filters, OAuth, /reload-mcp, and a least-privilege trust checklist before gateway or cron use.

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
How to Set Up Hermes Browser Automation with Playwright and Browserbase

Configure Hermes browser automation safely: choose local Chromium or Browserbase, set credentials, run a real Playwright-style smoke test, capture screenshots, and keep logged-in workflows gated.

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)

Run Hermes entirely offline with Ollama — no API keys, no cloud, complete privacy with local LLMs.

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.