Two Things Named Hermes
If you search for “Hermes” in the context of Nous Research, you will find two genuinely different products sharing a name, and confusing them is the single most common mistake newcomers make.
The Hermes model family is a line of open-weight LLMs, fine-tuned by Nous Research on top of base models from Meta, Alibaba, and ByteDance. Hermes 3 (2024) and Hermes 4.3 (built on ByteDance’s Seed 36B base, trained on Nous’s decentralized Psyche network) are instruction-tuned checkpoints with a function-calling format baked directly into their training data. You can download these weights and run them yourself.
Hermes Agent is a separate, much newer piece of software: an open-source agent runtime that Nous Research launched in early 2026. It is not a model. It is the scaffolding that turns any sufficiently capable model, Hermes-branded or not, into a persistent, tool-using, self-improving agent. This course is about Hermes Agent.
Why this matters: every code snippet in this course points Hermes Agent at whatever model makes sense for the task, Claude, GPT, Gemini, a local Qwen checkpoint. You are not locked into the Hermes model family to use Hermes Agent, and most production deployments do not use a Hermes-branded model at all.
What Makes It an Agent, Not a Chatbot Wrapper
A chatbot wrapper takes a prompt, calls a model, and prints the response. Hermes Agent is built around a closed learning loop: it can act (call tools, run shell commands, browse the web, edit files), observe the result, remember what it learned, and carry that memory into the next session and the next task.
flowchart LR
U["You: a request"] --> ORCH["Hermes orchestration layer"]
ORCH --> MODEL["Model of your choice\n(Claude, GPT, Gemini, local Qwen...)"]
MODEL --> ORCH
ORCH --> TOOLS["Tools & MCP servers"]
TOOLS --> ORCH
ORCH --> MEM[("Persistent memory\n+ skills on disk")]
MEM --> ORCH
ORCH --> OUT["Result, and a slightly\nsmarter agent next time"]
style U fill:#EEF0F7,stroke:#6366F1,color:#0F172A
style ORCH fill:#EEF0F7,stroke:#6366F1,color:#0F172A
style MODEL fill:#f0fdf9,stroke:#0D9488,color:#0F172A
style TOOLS fill:#f0fdf9,stroke:#0D9488,color:#0F172A
style MEM fill:#fff7ed,stroke:#f59e0b,color:#0F172A
style OUT fill:#EEF0F7,stroke:#6366F1,color:#0F172A
Three properties set this apart from a typical single-purpose agent script:
- Model-agnostic by design. Hermes talks to over a dozen provider backends through a common interface: hosted APIs (Nous Portal, OpenRouter, Anthropic, OpenAI, Google, xAI, DeepSeek), OAuth-based subscriptions, and self-hosted endpoints (Ollama, vLLM, llama.cpp, LM Studio). You are never locked into one vendor.
- A closed learning loop. Skills, memory, and sub-agent delegation are first-class features, not bolted-on plugins. The agent-curated memory and the skills system are covered in Module 4.
- Provider- and deployment-agnostic execution. The same agent can run on your laptop, inside a Docker container, over SSH on a remote box, or in a serverless sandbox that hibernates between sessions. Module 5 covers every backend.
What’s Actually in a Hermes Agent Installation
When you install Hermes (next lesson), you get a CLI (hermes), a terminal UI (hermes --tui), and a background gateway process that can bridge the same agent to messaging platforms like Telegram, Discord, and Slack. Configuration lives in two places you will return to constantly throughout this course:
| Location | Contents |
|---|---|
~/.hermes/.env | Secrets: API keys, tokens |
~/.hermes/config.yaml | Non-secret configuration: model, provider, terminal backend, MCP servers |
~/.hermes/skills/ | Skills the agent has learned or that you have dropped in manually |
Common pitfall: treating Hermes Agent as interchangeable with a LangGraph or CrewAI script you’d write from scratch. Those are libraries you compose into your own application. Hermes Agent is closer to a complete, opinionated runtime, you configure it and run it, rather than importing it as a dependency in a larger codebase. Module 8 compares these approaches directly once you have hands-on experience with both sides.
Why This Is Worth Learning Now
By mid-2026, Hermes Agent had become one of the most widely used open-source agent frameworks, reportedly the most-used agent on OpenRouter by request volume, according to Nous Research and covered on NVIDIA’s RTX AI Garage blog. That adoption is not the reason to learn it, though. The reason is architectural: Hermes demonstrates a working pattern for agent autonomy, model-agnostic orchestration, persistent memory, self-writing skills, sandboxed execution, that you will see echoed across the next generation of agent tooling regardless of which specific framework your team ends up shipping with.
Exercise before continuing: Open the Hermes Agent GitHub repository and skim the README. Note three things it claims to do that a plain chat interface to an LLM API cannot. You will verify each one hands-on by the end of Module 4.