by NousResearch
The agent that grows with you
# Add to your Claude Code skills
git clone https://github.com/NousResearch/hermes-agentLast scanned: 4/15/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-04-15T06:00:56.240Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": false
}The self-improving AI agent built by Nous Research. It's the only agent with a built-in learning loop — it creates skills from experience, improves them during use, nudges itself to persist knowledge, searches its own past conversations, and builds a deepening model of who you are across sessions. Run it on a $5 VPS, a GPU cluster, or serverless infrastructure that costs nearly nothing when idle. It's not tied to your laptop — talk to it from Telegram while it works on a cloud VM.
Use any model you want — Nous Portal, OpenRouter (200+ models), NVIDIA NIM (Nemotron), Xiaomi MiMo, z.ai/GLM, Kimi/Moonshot, MiniMax, Hugging Face, OpenAI, or your own endpoint. Switch with hermes model — no code changes, no lock-in.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Works on Linux, macOS, WSL2, and Android via Termux. The installer handles the platform-specific setup for you.
Android / Termux: The tested manual path is documented in the Termux guide. On Termux, Hermes installs a curated
.[termux]extra because the full.[all]extra currently pulls Android-incompatible voice dependencies.Windows: Native Windows is not supported. Please install WSL2 and run the command above.
After installation:
source ~/.bashrc # reload shell (or: source ~/.zshrc)
hermes # start chatting!
hermes # Interactive CLI — start a conversation
hermes model # Choose your LLM provider and model
hermes tools # Configure which tools are enabled
hermes config set # Set individual config values
hermes gateway # Start the messaging gateway (Telegram, Discord, etc.)
hermes setup # Run the full setup wizard (configures everything at once)
hermes claw migrate # Migrate from OpenClaw (if coming from OpenClaw)
hermes update # Update to the latest version
hermes doctor # Diagnose any issues
Hermes has two entry points: start the terminal UI with hermes, or run the gateway and talk to it from Telegram, Discord, Slack, WhatsApp, Signal, or Email. Once you're in a conversation, many slash commands are shared across both interfaces.
| Action | CLI | Messaging platforms |
|---------|-----|---------------------|
| Start chatting | hermes | Run hermes gateway setup + hermes gateway start, then send the bot a message |
| Start fresh conversation | /new or /reset | /new or /reset |
| Change model | /model [provider:model] | /model [provider:model] |
| Set a personality | /personality [name] | /personality [name] |
| Retry or undo the last turn | /retry, /undo | /retry, /undo |
| Compress context / check usage | /compress, /usage, /insights [--days N] | /compress, /usage, /insights [days] |
| Browse skills | /skills or /<skill-name> | /<skill-name> |
| Interrupt current work | Ctrl+C or send a new message | /stop or send a new message |
| Platform-specific status | /platforms | /status, /sethome |
For the full command lists, see the CLI guide and the Messaging Gateway guide.
All documentation lives at hermes-agent.nousresearch.com/docs:
| Section | What's Covered | |---------|---------------| | Quickstart | Install → setup → first conversation in 2 minutes | | CLI Usage | Commands, keybindings, personalities, sessions | | Configuration | Config file, providers, models, all options | | Messaging Gateway | Telegram, Discord, Slack, WhatsApp, Signal, Home Assistant | | Security | Command approval, DM pairing, container isolation | | Tools & Toolsets | 40+ tools, toolset system, terminal backends | | Skills System | Procedural memory, Skills Hub, creating skills | | Memory | Persistent memory, user profiles, best practices | | MCP Integration | Connect any MCP server for extended capabilities | | Cron Scheduling | Scheduled tasks with platform delivery | | Context Files | Project context that shapes every conversation | | Architecture | Project structure, agent loop, key classes | | Contributing | Development setup, PR process, code style | | CLI Reference | All commands and flags | | Environment Variables | Complete env var reference |
If you're coming from OpenClaw, Hermes can automatically import your settings, memories, skills, and API keys.
During first-time setup: The setup wizard (hermes setup) automatically detects ~/.openclaw and offers to migrate before configuration begins.
Anytime after install:
hermes claw migrate # Interactive migration (full preset)
hermes claw migrate --dry-run # Preview what would be migrated
hermes claw migrate --preset user-data # Migrate without secrets
hermes claw migrate --overwrite # Overwrite existing conflicts
What gets imported:
~/.hermes/skills/openclaw-imports/--workspace-target)See hermes claw migrate --help for all options, or use the openclaw-migration skill for an interactive agent-guided migration with dry-run previews.
We welcome contributions! See the [Contributing Guide](https://hermes-agent.nousresearch.com/do
No comments yet. Be the first to share your thoughts!
Based on votes and bookmarks from developers who liked this skill