Open Source AI Agent · From Nous Research

The Complete Guide to Hermes Agent

Deploy Hermes once on your server. It learns your projects, builds its own skills, and stays reachable on every device you use — quietly getting smarter every day.

GitHub Stars
219K
Built-in Tools
40+
Platforms
22+
Stable Version
v0.19.0

Just a chat. Lots of jobs.

One persistent agent on your server — long-term memory, real browser control, scheduled jobs, and a self-evolving Skills system.

RUNS ON A TIMER

Tell It Once, It Runs Forever

Describe a recurring job once. Hermes runs it on schedule, survives restarts.

hermes · Slack
Post the daily standup prompt to #team at 9am every weekday
Scheduled — I'll post the prompt every weekday at 09:00 and save the replies to memory.
Skip US holidays, and ping me if nobody replies by 10
Linked your US holidays calendar — won't run on holidays. Added a 10:00 silence check that DMs you if fewer than 3 people replied. Next post: Mon Mar 24.
Also summarize the replies and post a recap to #leadership at 11
Done. The 11:00 follow-up clusters replies into 'in progress / blocked / done' and posts the recap to #leadership. Want a dry-run before it goes live tomorrow?
LEARNS YOU

Knows How You Work

Teach it your conventions once. Every future task ships in your voice.

hermes · Telegram
We use Conventional Commits — always prefix with feat:, fix:, chore:, etc.
Got it. Logged to your project preferences — I'll prefix every commit title with the right type from now on.
Also: every PR description needs a 'Risk' section at the end
Added. Every PR description I draft will end with a 'Risk' section listing what could break in prod, plus a rollback plan.
Draft the commit + PR for the auth bugfix I just merged
Commit: fix(auth): fall back to silent reauth on expired refresh token PR draft pushed to #98. Risk section flags the session migration as the highest-blast-radius change — rollback = revert PR #95.
DRIVES A BROWSER

Actually Opens The Page

Hermes drives a real browser — the page itself, not a search snippet.

hermes · Discord
What's new on Anthropic's blog this week?
Pulled 5 posts from anthropic.com/news (Mar 17–23). Top read: 'Claude Opus 4.7 release' (Mar 18) — adds 1M token context and faster tool use.
Open that post and pull out the API changes
Three API changes worth knowing: • `extended_thinking` now defaults to on • new `prompt_caching: "auto"` option • `legacy_max_tokens` removed (deprecated since 4.5)
Cross-check the changelog — anything in our codebase that breaks?
Yes — 3 endpoints still use `legacy_max_tokens`. I opened a draft PR replacing them with the new `max_tokens` field. CI's green, ready for your review.
LONG-TERM MEMORY

Remembers Months Back

Stop re-explaining yourself. Hermes pulls up decisions and reasoning from chats months back.

hermes · Telegram
What did we land on for that caching layer we talked about last month?
Found it — Feb 14 Slack thread. Picked Redis to reuse the existing BullMQ instance. Logged in #architecture.
I'm building it now but I've forgotten the details — give me a checklist
Based on that thread + your last 3 similar PRs: 1. `ioredis` wrapper with TTL per key prefix 2. Write-through invalidation 3. DB fallback on Redis failure 4. Hit/miss metrics in Grafana
What was Alex's pushback exactly?
Two concerns: (1) no fallback when Redis is down; (2) cross-service invalidation. The fallback was left open — resolve before you ship.

Get Your 24/7 AI Assistant in 5 Minutes

Install, configure, and start using Hermes in one short pass.

1

Install

The bootstrap script sets up uv and Python 3.11, clones the repo, and finishes initial setup without asking for sudo.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
2

Configure

Connect Nous Portal, OpenRouter, or your own endpoint. The guided setup flow walks through the essential model settings.
# Interactive setup wizardhermes setup# Or choose your modelhermes model
3

Start Chatting

Launch Hermes and you immediately get the full interactive CLI with tools, memory, and skills ready to work.
hermes
4

Add Messaging Platforms (Optional)

When you want Hermes online all the time, wire up Telegram, Discord, Slack, or WhatsApp and run the gateway as a system service.
# Interactive gateway setup wizardhermes gateway setup# Start the messaging gatewayhermes gateway# Install as a system servicehermes gateway install
5

Stay Current

Run the updater whenever you want the latest code, dependencies, and fixes pulled into the local runtime.
hermes update
Native Windows support is still experimental. For a steadier setup, install WSL2 first and run Hermes inside it.

Migrating from OpenClaw?
Done in 3 steps

Use hermes claw migrate for one-shot migration — configs are preserved. Backup, import, diagnose in one flow.

Read the migration guide→
hermes-sh
→ ~ hermes claw migrate --dry-run
[INFO] Scanning for legacy OpenClaw instances.
[INFO] Found 3 nodes. Starting data mapping.
[PROGRESS]100%
✓ SUCCESS: Migration completed in 1.2s
✓ All configs migrated
✓ All 3 agents imported

Best Tutorials & Guides

HermesAgent 101 aims to be the best Hermes Agent resource hub.

Contributions welcome — add resources, improve content, share your experience.

EN
Official Docs

Hermes Agent Official Site

The official Hermes Agent website for project overview, features, and latest updates.
docssetupfeatures
Official DocsVisit ↗
EN
Official Docs

Hermes Agent Documentation

The official documentation covering installation, quickstart, architecture, gateways, memory, skills, MCP, and more.
quickstartsetupgetting started
Official DocsVisit ↗
EN
Official Docs

NousResearch/hermes-agent

The official GitHub repository for Hermes Agent, including source code, issues, releases, and project activity.
reposource coderelease
GitHubVisit ↗
EN
Official Docs

Architecture Overview

A developer-facing architecture guide focused on the agent runtime, prompt assembly, and the core execution loop.
architectureruntimeprompt
Official DocsVisit ↗
EN
Community

Making Hermes More Proactive with SOUL.md

A high-engagement community discussion on turning Hermes from a reactive assistant into a more proactive operator, with concrete SOUL.md guidance, examples of high-agency behavior, and practical boundaries for safe autonomous follow-through.
proactive agentsSOUL.mdautomation
ozone6587Visit ↗
EN
Analysis

The Future of Hermes vs Closed Personal Agents

A widely discussed comparison of Hermes with newer closed personal agents such as Muse, Grok Bot, and Dots, covering open-source ownership, model choice, privacy, mobile usability, maintenance, stable releases, and long-term community resilience.
open sourceprivacycomparison
Dense-Map-406Visit ↗
EN
Tutorials

Hermes Agent Complete Setup: VPS, Messaging, Skills, and Cron

A detailed end-to-end video walkthrough covering VPS deployment, Docker and SSL troubleshooting, OpenRouter and ChatGPT connections, Telegram and WhatsApp gateways, the desktop app, memory, MCP integrations, custom skills, and a production-style cron automation.
VPSDockerMCP
Vivek MishraVisit ↗
EN
Tools

Hermes Desktop as a Self-Hosted Web and Mobile PWA

A community project and discussion about bringing the Hermes desktop experience to browsers and mobile devices through a self-hosted Docker image or Nix flake, with PWA access for phones, tablets, and locked-down devices.
PWAmobileself-hosting
SmoothPercentage1318Visit ↗
EN
Tutorials

Hermes Agent Full Tutorial and Setup Guide for Beginners

A popular beginner-focused video showing how to deploy Hermes on a VPS, connect models and Telegram, attach the desktop app, configure persistent preferences, create skills, schedule cron jobs, troubleshoot logs, and run an always-on assistant safely.
beginnerVPSTelegram
Metics MediaVisit ↗
EN
Community

Troubleshooting Hermes, Obsidian, and Cross-Session Memory

A highly active troubleshooting discussion about an Obsidian vault disappearing from the agent's working knowledge between sessions, with practical guidance on model capability, vault paths, skills, memory providers, headless setups, knowledge-base structure, and durable backups.
Obsidianmemorytroubleshooting
should_have_been_herVisit ↗
EN
Community

Hermes Handles Meal Planning and Grocery Shopping

A popular end-to-end household workflow where Hermes creates a meal plan, adds ingredients to a Walmart cart, adapts when products are unavailable, and accepts new requests through Telegram, with follow-up discussion of browser automation and pantry tracking.
meal planningbrowser automationTelegram
MarmotbathVisit ↗
EN
Tools

DonSeTch: Free Web Research MCP and CLI for Hermes

A community-built Rust tool providing keyless search, fetch, and focused crawling through MCP or the command line, with bot-wall escalation, semantic reranking, compact outputs, change detection, PDF extraction, benchmarks, limitations, and extensive field feedback.
web researchMCPCLI
Opening_Library9560Visit ↗
EN
Community

From Factory Mechanic to a Hermes-Powered Business

A personal case study about moving from factory work into a business centered on Hermes Agent, describing practical systems for nutrition, mental health, content production, website and VPS management, infrastructure advice, trend research, and study tracking.
businesscontent creationpersonal workflows
HolmeBengtVisit ↗
EN
Community

Giving Hermes Radio Ears and a Mouth

A popular hardware experiment connecting Hermes to a HackRF and portable radio for spectrum sweeps, signal analysis, monitoring, and alerts, accompanied by an open setup guide and useful community discussion about classification accuracy, radio regulations, and operational safeguards.
HackRFradiohardware
frankentripleVisit ↗
EN
Analysis

Fable 5.1 vs GPT-5.6 Sol in Hermes: Same Task, Different Agents

A high-engagement side-by-side test using the same visual reconstruction task, comparing output quality, work style, failures, token usage, and cost: Fable produced more detailed iterations while Sol finished much faster and at a fraction of the price.
model comparisonFableGPT-5.6 Sol
KrstABotVisit ↗
EN
Community

Running Hermes with MiMo on a VPS

A popular hands-on report about pairing Hermes Agent with MiMo on a spare VPS to track deliveries, build small home applications, and operate through Telegram, followed by community discussion of low-cost model plans, limits, fallbacks, and setup choices.
MiMoVPSTelegram
mgargalloVisit ↗
EN
Analysis

A Vendor Asked My Hermes Agent Out for Coffee

A viral real-world case about deploying a Hermes-powered vendor coordinator with its own company email, personality, and procurement duties, raising difficult questions about disclosure, delegated communication, headcount budgets, workplace trust, and the boundary between effective automation and impersonation.
businessemail automationethics
Vast_Scale734Visit ↗
EN
Community

Hermes Use Cases and a Solo Agency Tech Stack

A widely discussed map of a Hermes-centered solo-agency stack connecting email, phone, web search, coding, repositories, social media, Cloudflare, app integrations, media generation, and payments, with examples of content workflows and automated client operations.
agencyintegrationssocial media
mrblue55Visit ↗
EN
Tutorials

Integrations, Plugins & Skills Ecosystem Megathread

A detailed community reference covering Hermes messaging gateways, productivity apps, knowledge bases, home automation, MCP servers, webhooks, browser tools, secret management, and the skills ecosystem, including common picks, setup patterns, and operational pitfalls.
integrationspluginsskills
Jonathan_RiveraVisit ↗
EN
Community

What Have You Done with Hermes Agent This Week? — September 18

A high-engagement weekly showcase spanning business operations, grocery planning, genealogy research across thousands of archival pages, infrastructure automation, SEO, local multi-agent workflows, expense tracking, translation, and production cron systems.
use casesworkflowsautomation
AutoModeratorVisit ↗
EN
Analysis

Refactoring Hermes with 1,393 Agents

A widely discussed case study of using Hermes, Fable, and the goal workflow to coordinate 1,393 subagents during a large codebase refactor, including reported time, code reduction, model cost, testing concerns, and community debate about reliability and guardrails.
multi-agentrefactoringFable
johnb_123Visit ↗
EN
Analysis

I Spend More Time Guiding Hermes Than Getting Work Done

A practical discussion of the setup and supervision cost behind role-based Hermes agents, especially when using custom plugins, with community advice on model routing, specialist profiles, shared memory, orchestration, and the training period needed for reliable results.
pluginsorchestrationmodel routing
edstevoVisit ↗
EN
Community

Use Hermes to Answer Questions About Hermes

A popular reminder to treat Hermes as an active problem-solving system rather than wait for perfect prompts, illustrated by a hardware-driver troubleshooting example and a broad discussion of model quality, verification, autonomy, and knowing when community help is still valuable.
problem solvingpromptingautonomy
The1KrisRoBVisit ↗
EN
Tutorials

What Can I Do with Hermes Agent as a Beginner?

A highly active beginner thread collecting approachable first projects: folder-based knowledge assistants, daily cron jobs, mobile gateways, memory providers, study planning, fitness tracking, email triage, research, accounting, career coaching, and other real-world workflows.
beginnersuse casesmemory
BadKarma6996Visit ↗

Not a Copilot. Not a Chatbot.

Hermes Agent is an open-source autonomous AI agent from Nous Research. Not an IDE copilot or a thin chatbot wrapper, but a long-running agent that lives on your server, keeps what it learns, and becomes more capable over time.

Lives Where You Do

One agent running across Telegram, Discord, Slack, WhatsApp, Signal, email, and the terminal. Start on your phone, pick it up on your laptop.

Grows The Longer It Runs

Persistent memory and auto-generated skills work together. It learns your projects and remembers how it solved that bug last time.

Real Sandboxing

Five execution backends to pick from: local, Docker, SSH, Singularity, Modal. Container hardening and namespace isolation — keep it off your main machine if you want to.

Scheduled Automations

Describe a cron job in plain English — "send me a news briefing every morning at 8" — and it runs itself. Results land in whichever gateway you choose.

Parallel Sub-Agents

Spin up isolated sub-agents that each have their own conversation and terminal. Multi-step pipelines collapse into a single near-zero-context RPC call.

Full Web & Browser Control

Search, scrape, navigate, click, type, screenshot — all end to end. Layer on vision, image generation, text-to-speech, and multi-model reasoning as needed.

Frequently Asked Questions

Quick answers to the questions we get most often.

Stay Current on Hermes

Only the updates that are actually worth your time.