7d2b3b767d
Merge upstream b1f003e186 while preserving PM runtime ownership and
Python 3.14 worker startup, Windows signing, and macOS wait recovery.
Keep retired runtime modules deleted. Port upstream updater preflight
checks into the checkout strategy and preserve live build logging.
Carry checkpoint filename handling and process recovery into the current
module layout. Regenerate locks and adapt incoming platform test markers.
Focused Python and JavaScript tests, desktop and root-test typechecks,
conflict-path lint checks, lock validation, and retired-import checks pass.
The full test suite and packaged release builds were not run.
158 lines
8.9 KiB
Plaintext
158 lines
8.9 KiB
Plaintext
---
|
|
slug: /
|
|
sidebar_position: 0
|
|
title: "Hermes Agent Documentation"
|
|
description: "The self-improving AI agent built by Nous Research. A built-in learning loop that creates skills from experience, improves them during use, and remembers across sessions."
|
|
hide_table_of_contents: true
|
|
displayed_sidebar: docs
|
|
---
|
|
|
|
import Link from "@docusaurus/Link";
|
|
|
|
# Hermes Agent
|
|
|
|
The self-improving AI agent built by [Nous Research](https://nousresearch.com). The only agent with a built-in learning loop — it creates skills from experience, improves them during use, nudges itself to persist knowledge, and builds a deepening model of who you are across sessions.
|
|
|
|
<div
|
|
style={{
|
|
display: "flex",
|
|
gap: "1rem",
|
|
marginBottom: "2rem",
|
|
flexWrap: "wrap",
|
|
}}
|
|
>
|
|
<Link
|
|
to="/getting-started/installation"
|
|
style={{
|
|
display: "inline-block",
|
|
padding: "0.6rem 1.2rem",
|
|
backgroundColor: "#FFD700",
|
|
color: "#07070d",
|
|
borderRadius: "8px",
|
|
fontWeight: 600,
|
|
textDecoration: "none",
|
|
}}
|
|
>
|
|
Get Started →
|
|
</Link>
|
|
<Link
|
|
to="/user-guide/bot-mode"
|
|
style={{
|
|
display: "inline-block",
|
|
padding: "0.6rem 1.2rem",
|
|
border: "1px solid rgba(255,215,0,0.2)",
|
|
borderRadius: "8px",
|
|
textDecoration: "none",
|
|
}}
|
|
>
|
|
Explore Bot Mode
|
|
</Link>
|
|
<a
|
|
href="https://hermes-agent.nousresearch.com/"
|
|
style={{
|
|
display: "inline-block",
|
|
padding: "0.6rem 1.2rem",
|
|
border: "1px solid rgba(255,215,0,0.2)",
|
|
borderRadius: "8px",
|
|
textDecoration: "none",
|
|
}}
|
|
>
|
|
Download Desktop
|
|
</a>
|
|
<a
|
|
href="https://github.com/NousResearch/hermes-agent"
|
|
style={{
|
|
display: "inline-block",
|
|
padding: "0.6rem 1.2rem",
|
|
border: "1px solid rgba(255,215,0,0.2)",
|
|
borderRadius: "8px",
|
|
textDecoration: "none",
|
|
}}
|
|
>
|
|
View on GitHub
|
|
</a>
|
|
</div>
|
|
|
|
## Install
|
|
|
|
### Windows or macOS
|
|
|
|
To easily install the command-line and desktop applications, [download the Hermes Desktop installer](https://hermes-agent.nousresearch.com/) from our website and run it.
|
|
|
|
### Without Hermes Desktop:
|
|
|
|
For a command-line only install without Hermes Desktop, run:
|
|
|
|
For aarch64 Android devices, use the separate [Termux APT guide](./getting-started/termux.md).
|
|
|
|
#### Linux / macOS / WSL2
|
|
|
|
```bash
|
|
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
|
|
```
|
|
|
|
#### Windows (native)
|
|
|
|
Run in powershell:
|
|
|
|
```powershell
|
|
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
|
|
```
|
|
|
|
See the full **[Installation Guide](/getting-started/installation)** for what the installer does, installation ownership and data locations, and Windows-specific notes. For the complete platform support matrix, see **[Platform Support](/getting-started/platform-support)**.
|
|
|
|
:::tip Fastest path to a working agent
|
|
After installing, run `hermes setup --portal` — one OAuth covers a model plus all four Tool Gateway tools (web search, image generation, TTS, browser). See [Nous Portal](/integrations/nous-portal).
|
|
:::
|
|
|
|
## What is Hermes Agent?
|
|
|
|
It's not a coding copilot tethered to an IDE or a chatbot wrapper around a single API. It's an **autonomous agent** that gets more capable the longer it runs. It lives wherever you put it — a $5 VPS, a GPU cluster, or serverless infrastructure (Daytona, Modal) that costs nearly nothing when idle. Talk to it from Telegram while it works on a cloud VM you never SSH into yourself. It's not tied to your laptop.
|
|
|
|
## Quick Links
|
|
|
|
| | |
|
|
| ----------------------------------------------------------------------- | --------------------------------------------------------------------- |
|
|
| 🚀 **[Installation](/getting-started/installation)** | Install in 60 seconds on Linux, macOS, WSL2, native Windows, Nix & NixOS or Android |
|
|
| 📖 **[Quickstart Tutorial](/getting-started/quickstart)** | Your first conversation and key features to try |
|
|
| 🗺️ **[Learning Path](/getting-started/learning-path)** | Find the right docs for your experience level |
|
|
| ⚙️ **[Configuration](/user-guide/configuration)** | Config file, providers, models, and options |
|
|
| 💬 **[Messaging Gateway](/user-guide/messaging)** | Set up Telegram, Discord, Slack, WhatsApp, Teams, or more |
|
|
| 🤖 **[Bot Mode](/user-guide/bot-mode)** | Named Bots with their own model, memory, skills, routines, and chats |
|
|
| 🔧 **[Tools & Toolsets](/user-guide/features/tools)** | 60+ built-in tools and how to configure them |
|
|
| 🧠 **[Memory System](/user-guide/features/memory)** | Persistent memory that grows across sessions |
|
|
| 📚 **[Skills System](/user-guide/features/skills)** | Procedural memory the agent creates and reuses |
|
|
| 🔌 **[MCP Integration](/user-guide/features/mcp)** | Connect to MCP servers, filter their tools, and extend Hermes safely |
|
|
| 🧭 **[Use MCP with Hermes](/guides/use-mcp-with-hermes)** | Practical MCP setup patterns, examples, and tutorials |
|
|
| 🎙️ **[Voice Mode](/user-guide/features/voice-mode)** | Real-time voice interaction in CLI, Telegram, Discord, and Discord VC |
|
|
| 🗣️ **[Use Voice Mode with Hermes](/guides/use-voice-mode-with-hermes)** | Hands-on setup and usage patterns for Hermes voice workflows |
|
|
| 🎭 **[Personality & SOUL.md](/user-guide/features/personality)** | Define Hermes' default voice with a global SOUL.md |
|
|
| 📄 **[Context Files](/user-guide/features/context-files)** | Project context files that shape every conversation |
|
|
| 🔒 **[Security](/user-guide/security)** | Command approval, authorization, container isolation |
|
|
| 💡 **[Tips & Best Practices](/guides/tips)** | Quick wins to get the most out of Hermes |
|
|
| 🏗️ **[Architecture](/developer-guide/architecture)** | How it works under the hood |
|
|
| ❓ **[FAQ & Troubleshooting](/reference/faq)** | Common questions and solutions |
|
|
|
|
## Key Features
|
|
|
|
- **A closed learning loop** — Agent-curated memory with periodic nudges, autonomous skill creation, skill self-improvement during use, FTS5 cross-session recall with LLM summarization, and [Honcho](https://github.com/plastic-labs/honcho) dialectic user modeling
|
|
- **Runs anywhere, not just your laptop** — 7 terminal backends: local, Docker, SSH, Daytona, Singularity, Modal, Vercel Sandbox. Daytona and Modal offer serverless persistence — your environment hibernates when idle, costing nearly nothing
|
|
- **Lives where you do** — CLI, Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Mattermost, Email, SMS, DingTalk, Feishu, WeCom, Weixin, QQ Bot, Yuanbao, BlueBubbles, Home Assistant, Microsoft Teams, Google Chat, and more — 20+ platforms from one gateway
|
|
- **Built by model trainers** — Created by [Nous Research](https://nousresearch.com), the lab behind Hermes, Nomos, and Psyche. Works with [Nous Portal](https://portal.nousresearch.com), [OpenRouter](https://openrouter.ai), OpenAI, or any endpoint
|
|
- **Scheduled automations** — Built-in cron with delivery to any platform
|
|
- **[Bot Mode](/user-guide/bot-mode)** — Build a durable team of specialist Bots that work together in group chats and through `@mentions`
|
|
- **Delegates & parallelizes** — Spawn isolated subagents for parallel workstreams. Programmatic Tool Calling via `execute_code` collapses multi-step pipelines into single inference calls
|
|
- **Open standard skills** — Compatible with [agentskills.io](https://agentskills.io). Skills are portable, shareable, and community-contributed via the Skills Hub
|
|
- **Full web control** — Search, extract, browse, vision, image generation, TTS — one subscription via [Nous Portal](/integrations/nous-portal) bundles all of them
|
|
- **MCP support** — Connect to any MCP server for extended tool capabilities
|
|
- **Research-ready** — Batch processing, trajectory export, RL training with Atropos. Built by [Nous Research](https://nousresearch.com) — the lab behind Hermes, Nomos, and Psyche models
|
|
|
|
## For LLMs and coding agents
|
|
|
|
Machine-readable entry points to this documentation:
|
|
|
|
- **[`/llms.txt`](/llms.txt)** — curated index of every doc page with short descriptions. ~17 KB, safe to load into an LLM context.
|
|
- **[`/llms-full.txt`](/llms-full.txt)** — every doc page concatenated into a single markdown file for one-shot ingestion. ~1.8 MB.
|
|
|
|
Both files also resolve at `/docs/llms.txt` and `/docs/llms-full.txt`. Generated fresh on every deploy.
|