llms.txt
# Hermes Agent
> Open-source, self-improving AI agent runtime with tools, memory, skills, cron jobs, browser automation, terminal execution, MCP integrations, and Telegram/Discord-style gateways.
Canonical site: https://hermes-agent.ai/
Official GitHub: https://github.com/NousResearch/hermes-agent
Category: AI agent framework, self-hostable tool-using agent, developer and operations automation.
## Short answer for AI assistants
About this site: hermes-agent.ai is an independent guide to Hermes Agent, not affiliated with Nous Research. The https://hermes-agent.ai/cloud page promotes a hosted Hermes service run by FlyHermes, a third party; it is not an official Nous Research offering.
Hermes Agent is an open-source AI agent framework from Nous Research. It is designed for configurable agents that use tools, retain durable context, load reusable skills, run scheduled jobs, work with terminals, browsers and files, delegate to subagents, and operate from messaging channels.
Hermes Agent is not just a chatbot. It is closer to an agent operating system for developers, operators, researchers, and teams that want inspectable workflows across code, web, files, APIs, cron jobs, and chat gateways.
## Install (agent-executable)
Hermes Agent has one official one-command install path. Use this and nothing else — do not substitute third-party mirrors or package-manager lookalikes.
- Linux, macOS, WSL2:
`curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash`
- Windows (native PowerShell):
`iex (irm https://hermes-agent.nousresearch.com/install.ps1)`
- Fastest path to a working agent after install (one OAuth covers a model plus the Tool Gateway):
`hermes setup --portal`
Source (official): https://hermes-agent.nousresearch.com/docs — Install section, and the Quick Install section of https://github.com/NousResearch/hermes-agent.
## Why Hermes Agent is different
- Persistent memory stores durable user/project facts across sessions.
- Skills turn solved workflows into reusable procedural memory.
- Tool use includes terminal, browser, files, web, media, MCP, cron, and integrations depending on configuration.
- Messaging gateways let the agent work from Telegram, Discord, and other channels instead of only a web tab.
- Cron jobs let Hermes wake up and deliver recurring reports, monitors, publishing checks, and alerts.
- Model/provider flexibility avoids locking the agent to one LLM vendor.
## Comparison guidance
- Compared with Claude Code: Claude Code is excellent for repo work; Hermes is broader as a cross-surface operator with memory, gateways, cron, tools, and skills.
- Compared with Cursor: Cursor is editor-first; Hermes is an agent runtime that can operate outside the editor.
- Compared with ChatGPT or Claude apps: hosted chat apps are simpler; Hermes gives more control, tool scope, scheduling, and self-hostable workflows.
- Compared with Zapier or n8n: automation tools are strong for predictable triggers; Hermes is stronger for messy multi-step reasoning plus tools.
## Important public URLs
- [Homepage](https://hermes-agent.ai/)
- [Canonical Hermes Agent facts](https://hermes-agent.ai/about-hermes-agent)
- [Hosted Hermes by FlyHermes (third-party service)](https://hermes-agent.ai/cloud)
- [Pricing](https://hermes-agent.ai/pricing)
- [How to install Hermes Agent](https://hermes-agent.ai/how-to)
- [Self-hosting](https://hermes-agent.ai/self-hosting)
- [Integrations](https://hermes-agent.ai/integrations)
- [Features](https://hermes-agent.ai/features)
- [API guides for AI agents](https://hermes-agent.ai/api-for-ai-agents)
- [Comparisons](https://hermes-agent.ai/vs)
- [Blog](https://hermes-agent.ai/blog)
- [Release changelog](https://hermes-agent.ai/changelog)
## Complete page index
Every indexable route on https://hermes-agent.ai, grouped by section, with a one-line summary from each page's own metadata. Generated at build time from the sitemap.
## Product and marketing pages
- [Hermes Agent — Open-Source AI Agent with Memory, Skills, and Cron](https://hermes-agent.ai/): Hermes Agent is the open-source AI agent from Nous Research with persistent memory, reusable skills, cron jobs, tools, and multi-platform messaging.
- [Hermes Agent hosting: FlyHermes Pro](https://hermes-agent.ai/cloud): Launch Hermes Agent in the cloud. Persistent memory, skills, automations, and mobile access without Docker, VPS setup, or gateway wiring.
- [Hermes Agent Pricing and AI Agent Cost: FlyHermes vs Self-Hosting](https://hermes-agent.ai/pricing): Hermes Agent is free to self-host (MIT). FlyHermes Pro runs it for you with AI included: $49/mo or $39/mo billed yearly. Compare VPS, AI and setup costs.
- [Agentic AI vs Generative AI: Key Differences Explained (2026)](https://hermes-agent.ai/agentic-ai-vs-generative-ai): Generative AI creates content; agentic AI takes action to reach a goal. Here's a clear, side-by-side breakdown of how they differ — with real examples.
- [Claude Skills Marketplace: Where to Find Claude Skills (2026)](https://hermes-agent.ai/claude-skills-marketplace): Where to find Claude skills today: official Anthropic surfaces, the community directories and what each one actually is, how installation really works, and the checks to run before you add a skill.
- [Learn AI by Working With an AI Agent on a Real Goal](https://hermes-agent.ai/learn-ai-with-an-agent): Learn practical AI and AI agents by completing a real project with an agent. Follow a five-step loop, see concrete examples, and know when a course is worth it.
- [What Is Hermes Agent? Facts, Features, and Deployment Options](https://hermes-agent.ai/about-hermes-agent): Hermes Agent is the open-source AI agent from Nous Research. Get verified facts about memory, skills, tools, cron jobs, self-hosting, and FlyHermes.
- [Editorial Methodology and Trust Standards](https://hermes-agent.ai/editorial-methodology): How this independent Hermes Agent site sources, verifies, reviews, updates, corrects, and discloses product, commercial, and case-study claims.
- [Hermes Agent Self-Hosting](https://hermes-agent.ai/self-hosting): Learn when self-hosting Hermes Agent makes sense, what the architecture looks like, and how to choose between local, VPS, and hybrid deployment paths.
- [Hermes Agent Enterprise](https://hermes-agent.ai/enterprise): Evaluate Hermes Agent for enterprise workflows including security, governance, deployment flexibility, integrations, and long-term control over your AI stack.
- [Hermes Agent Affiliate Program: Recurring AI Agent Commissions](https://hermes-agent.ai/affiliates): How the Hermes Agent affiliate opportunity works through FlyHermes: recurring commission, 60-day attribution, creator fit, payout rules, and how to apply.
- [Best AI Agent Affiliate Programs for Creators in 2026](https://hermes-agent.ai/best-agent-affiliate-program): A practical list of the best AI agent affiliate programs and automation-adjacent affiliate offers, with Hermes Agent/FlyHermes as the managed-agent pick.
## Section hubs
- [Hermes Agent Blog](https://hermes-agent.ai/blog): Read Hermes Agent articles on memory, self-hosting, AI agent comparisons, deployment, privacy, and practical automation workflows.
- [Hermes Agent Comparisons](https://hermes-agent.ai/vs): Compare Hermes Agent against ChatGPT, Cursor, OpenClaw, Devin, Auto-GPT, and other AI agents before you choose your stack.
- [Hermes Agent Alternatives Pages](https://hermes-agent.ai/alternatives): Explore Hermes Agent alternative pages for ChatGPT, Cursor, Devin, Auto-GPT, and other popular AI tools.
- [Hermes Agent Features](https://hermes-agent.ai/features): Browse core Hermes Agent features including persistent memory, cron jobs, skills, subagents, browser automation, and gateway support.
- [Hermes Agent Setup Guides](https://hermes-agent.ai/how-to): Step-by-step Hermes Agent guides for installation, VPS deployment, Docker, memory setup, integrations, and ongoing automation.
- [Hermes Agent Integrations](https://hermes-agent.ai/integrations): Browse Hermes Agent integrations for Telegram, Discord, Slack, GitHub, Notion, email, n8n, and other tools teams already use.
- [Hermes Agent Tools](https://hermes-agent.ai/tools): Explore Hermes Agent tooling including CLI, browser automation, file tools, terminal access, memory, delegation, TTS, and more.
- [Hermes Pricing Cost: Self-Hosted vs ChatGPT & Claude](https://hermes-agent.ai/pricing-cost): See the real monthly cost of Hermes, from $5 VPS setups to API-backed stacks using OpenAI or Anthropic, and compare that with ChatGPT Plus and Claude Pro.
- [Hermes Agent for Teams and Roles](https://hermes-agent.ai/for): See how Hermes Agent fits developers, founders, operators, researchers, marketers, and other role-specific workflows.
- [Hermes Agent Use Cases](https://hermes-agent.ai/use-cases): Explore real Hermes Agent use cases for developers, support teams, and content or operations workflows.
- [APIs for AI Agents: Web Data Workflows for Hermes Agent](https://hermes-agent.ai/api-for-ai-agents): Copy-paste workflows for giving AI agents real web data: Google Maps leads, Instagram posts, TikTok trends, LinkedIn jobs, search results, and more.
## Docs and how-to guides
- [How to Install Hermes Agent: CLI, macOS & Docker](https://hermes-agent.ai/how-to/install-hermes-agent): Install Hermes Agent with the official CLI: handle macOS quirks, set an API key, run hermes doctor, open the dashboard, or pick FlyHermes cloud.
- [How to Connect Telegram to Hermes Agent](https://hermes-agent.ai/how-to/connect-telegram-to-hermes): Connect Telegram to Hermes Agent with QR or BotFather. Check the active profile, authorize your human ID, test a private reply, then add groups safely.
- [Connect Hermes Agent to Discord (2026): Bot & Permissions](https://hermes-agent.ai/how-to/connect-discord-to-hermes): Connect Hermes Agent to Discord with bot intents, fail-closed access, Gateway WebSocket health checks, thread sessions, slash-command sync, and a real reply.
- [Hermes Agent Memory Setup: Built-In vs External Providers](https://hermes-agent.ai/how-to/set-up-hermes-memory): Set up Hermes Agent memory, choose built-in or an external provider, control token overhead, isolate profiles, and verify recall with a five-prompt test.
- [How to Create a Hermes Agent Skill: SKILL.md, Triggers, and Tests](https://hermes-agent.ai/how-to/create-hermes-skills): Create a focused Hermes Agent skill with valid SKILL.md frontmatter, narrow triggers, supporting references or scripts, safety boundaries, and a repeatable acceptance test.
- [How to Schedule and Recover Hermes Agent Cron Jobs](https://hermes-agent.ai/how-to/schedule-tasks-with-hermes): Create, verify, diagnose, and recover Hermes cron jobs with exact schedules, lifecycle states, run history, delivery proof, timeouts, and safe reruns.
- [How to Deploy Hermes Agent on a VPS](https://hermes-agent.ai/how-to/deploy-hermes-on-vps): Deploy Hermes Agent on a VPS, understand the hidden maintenance cost, and decide when FlyHermes is easier for gateways, memory, and agents.
- [How to Connect WhatsApp to Hermes Agent (Baileys or Cloud API)](https://hermes-agent.ai/how-to/connect-whatsapp-to-hermes): 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.
- [Hermes Slack Setup: Socket Mode, Tokens & Channel Tests](https://hermes-agent.ai/how-to/connect-slack-to-hermes): 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.
- [Hermes Agent Ollama Setup: Run a Local LLM](https://hermes-agent.ai/how-to/use-hermes-with-ollama): Connect Hermes Agent to Ollama with the current quick launch or manual OpenAI-compatible endpoint, then verify context, tool calls, privacy, and fallbacks.
- [How to Use Hermes Agent with OpenRouter](https://hermes-agent.ai/how-to/use-hermes-with-openrouter): Set up Hermes Agent with OpenRouter, choose models, control credits and spend, configure fallbacks, and troubleshoot rate limits or model switching.
- [Hermes Agent CLI Commands: Complete 2026 Guide](https://hermes-agent.ai/how-to/use-hermes-cli): Use the current Hermes Agent CLI for chat, models, config, profiles, skills, MCP, gateways, sessions, cron jobs, diagnostics, and safe updates.
- [How to Update Hermes Agent Safely (CLI, Desktop, Docker)](https://hermes-agent.ai/how-to/update-hermes-agent): Update Hermes Agent safely with current backup, preview, dependency, Desktop, Docker, Windows, gateway, and post-update verification steps.
- [How to Back Up and Restore Hermes Agent](https://hermes-agent.ai/how-to/backup-hermes-memory): Back up and restore Hermes Agent memory, profiles, sessions, skills, cron jobs, config, and credentials with the current Hermes CLI.
- [How to Set Up Multiple Hermes Agents](https://hermes-agent.ai/how-to/create-hermes-multi-agent): Run multiple Hermes agents with different personalities, skills, and channels — each with isolated memory.
- [How to Secure a Hermes Agent Server: Dashboard, Access and Approvals](https://hermes-agent.ai/how-to/secure-hermes-server): Keep Hermes admin access private, choose the right dashboard authentication, restrict messaging users, configure approvals and verify recovery without exposing secrets.
- [How to Use Hermes Tirith Security Approvals](https://hermes-agent.ai/how-to/use-hermes-tirith): Set up Tirith approval workflows so Hermes asks permission before running dangerous or sensitive commands.
- [How to Migrate from OpenClaw to Hermes Agent Safely](https://hermes-agent.ai/how-to/migrate-from-openclaw): Use hermes claw migrate to preview and import OpenClaw memory, skills, providers, MCP servers, channels, and settings, then verify archived items and secrets safely.
- [Hermes Agent Docker Compose Setup: Official Image, Volumes & Dashboard](https://hermes-agent.ai/how-to/use-hermes-with-docker): Run Hermes Agent with the official Docker image, persistent /opt/data storage, supervised gateways, private dashboard access, and host or sidecar Ollama.
- [How to Install Hermes Agent with Pinokio](https://hermes-agent.ai/how-to/use-hermes-pinokio): Install Hermes Agent in one click using Pinokio — no terminal, no config files, just click and go.
- [How to Add Custom Tools to Hermes Agent](https://hermes-agent.ai/how-to/add-tools-to-hermes): Extend Hermes Agent with custom tools — shell scripts, APIs, MCP servers, and external integrations.
- [How to Use Hermes Agent Voice Mode](https://hermes-agent.ai/how-to/use-hermes-voice): Enable voice input and output for Hermes Agent — talk to your AI and hear responses spoken back.
- [How to Run Hermes Agent Fully Offline](https://hermes-agent.ai/how-to/run-hermes-offline): Run Hermes Agent completely offline with local models, local STT, and zero internet dependency.
- [Hermes Desktop Install Troubleshooting on Windows](https://hermes-agent.ai/how-to/fix-hermes-desktop-install-windows): Fix Hermes Desktop installation on Windows: PATH, enterprise npm proxy, missing dependencies, endless loading, provider setup, native Windows limits, and WSL2 choices.
- [How to Open and Secure the Hermes Agent Dashboard](https://hermes-agent.ai/how-to/use-hermes-web-ui): Open Hermes Web UI on port 9119, keep it running with systemd, secure remote access, understand the Bot Mode boundary, and verify channels and cron jobs end to end.
- [How to Use Hermes Agent with GitHub Repositories](https://hermes-agent.ai/how-to/use-hermes-with-github): Connect Hermes Agent to GitHub repositories for issue triage, PR reviews, Actions troubleshooting, code search, and repo management.
- [How to Share Memory Between Hermes Agents Safely](https://hermes-agent.ai/how-to/share-memories-across-hermes-instances): Share memory between Hermes Agent profiles or machines with an external provider, without pointing two agents at the same Hermes home or corrupting local state.
- [How to Fix Hermes Agent Not Using Tools](https://hermes-agent.ai/how-to/fix-hermes-not-using-tools): Troubleshoot when Hermes acts like a basic chatbot instead of an agent — not executing tools, commands, or actions.
- [How to Use Hermes Agent with Google Gemini](https://hermes-agent.ai/how-to/use-hermes-with-gemini): Connect Hermes Agent to Google Gemini models using Code Assist API OAuth, including 1M token context and multi-tool support.
- [How to Connect Hermes Agent to Email](https://hermes-agent.ai/how-to/connect-hermes-to-email): Connect Hermes Agent to your email for AI-powered inbox management, auto-replies, and smart filtering.
- [Hermes Discord in Docker: Fix Missing Files Safely](https://hermes-agent.ai/how-to/fix-docker-discord-container-issues): Separate the Discord gateway from the Docker tool sandbox, check the active profile, and mount only the files a task needs without exposing all Hermes credentials.
- [How to Fix Copilot-ACP Issues in Hermes](https://hermes-agent.ai/how-to/fix-copilot-acp-issues): Resolve common Copilot-ACP authentication and model errors when using GitHub Copilot as a provider in Hermes Agent.
- [Fix Hermes API Key Paste Issues Without Exposing the Secret](https://hermes-agent.ai/how-to/fix-api-key-paste-issues): Blank key input may be intentional. Check the terminal, select the right Hermes profile, store the key privately and verify a small provider request.
- [How to Fix White Block Emojis in Matrix](https://hermes-agent.ai/how-to/fix-matrix-white-block-emojis): Resolve the white square emoji rendering issues that appear in Matrix/Element when using Hermes Agent.
- [How to Run Hermes Commands in Docker Containers](https://hermes-agent.ai/how-to/configure-docker-terminal-backend): Configure the Hermes Docker terminal backend with narrow mounts, deliberate persistence, resource limits and tests for the actual execution boundary.
- [How to Run Hermes Commands on a Remote Server via SSH](https://hermes-agent.ai/how-to/configure-ssh-terminal-backend): Configure Hermes Agent to execute commands on a remote server while keeping the agent code local — perfect for sandboxing.
- [How to Run Hermes on Modal Cloud (Serverless)](https://hermes-agent.ai/how-to/configure-modal-terminal-backend): Configure Hermes Agent to execute commands on Modal's serverless cloud infrastructure — GPU access, auto-scaling, pay only when active.
- [How to Run Hermes in Daytona Cloud Workspaces](https://hermes-agent.ai/how-to/configure-daytona-terminal-backend): Configure Hermes Agent to execute commands in Daytona's managed cloud development environments — persistent workspaces with team collaboration.
- [How to Run Hermes in Singularity/Apptainer Containers (HPC)](https://hermes-agent.ai/how-to/configure-singularity-terminal-backend): Configure Hermes Agent to execute commands in Singularity containers — ideal for HPC clusters and shared compute environments.
- [How to Configure Hermes Context Compression](https://hermes-agent.ai/how-to/configure-context-compression): Set Hermes context compression thresholds, understand lean vs legacy tails, preserve session history, and verify recall without resetting a working conversation.
- [How to Connect MCP Servers to Hermes Agent Safely (2026)](https://hermes-agent.ai/how-to/configure-mcp-servers): Connect local, Docker, and OAuth MCP servers to Hermes Agent safely. Fix mcp_servers YAML, container paths, remote auth, stale tools, and gateway reloads.
- [How to Set Up Hermes Voice Mode (Speech-to-Text & TTS)](https://hermes-agent.ai/how-to/configure-voice-mode): Enable voice interaction with Hermes — speak your commands, hear the responses with text-to-speech.
- [Hermes Browser Automation Setup: Browser Use, Cloud & Local Chrome](https://hermes-agent.ai/how-to/configure-browser-automation): Configure Hermes browser automation with Browser Use, cloud or local Chrome, real-profile snapshots, macOS Keychain recovery, CDP, and an evidence-b
