Overview
{ width="100%" }
flowchart LR
A[You] --> B[Hermes CLI / Gateway]
B --> C[LLM Provider]
B --> D[Tools + MCP]
B --> E[Skills ~/.hermes/skills]
B --> F[Memory + Curator]
E --> G[Community ecosystem]
G --> H[wondelai/skills]
G --> I[GUI dashboards]
G --> J[Plugins + bridges]
F -->|7-day cycle| E
B --> K[18+ messaging platforms]
| Layer | What it is |
|---|---|
| Hermes core | CLI, gateway, 60+ tools, cron, profiles |
| Learning loop | Creates skills from experience; Curator grades/prunes (v0.12+) |
| Skills | Procedural memory — /skill or auto-invoked |
| Plugins / MCP | Extend tools, memory, search, payments |
| Ecosystem | Community skills, GUIs, deployment, multi-agent |
Session workflow¶
- Install Hermes → configure LLM provider
- Layer skills & plugins → tools & utilities → integrations
-
Add multi-agent orchestration; Curator improves skills every 7 days
-
Install Hermes — one-line installer (Part 1)
- Choose provider —
hermes setup --portalorhermes model(Part 2) - Skills & plugins —
./install-ecosystem.sh skills plugins(Part 4) - Tools & utilities — GUIs, SkillClaw, camofox (Part 5)
- Integrations & bridges — MCP, memory, M365 (Part 6)
- Multi-agent & swarms — oh-my-hermes, ACP, mission-control (Part 7)
Quick start¶
# 1. Install Hermes (macOS / Linux / WSL)
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.zshrc # or ~/.bashrc
# 2. Provider + Tool Gateway (easiest)
hermes setup --portal
# 3. Verify
cd guides/awesome-hermes-agent
chmod +x verify-install.sh install-starter-pack.sh
./verify-install.sh
# 4. First chat
hermes --tui
# 5. Ecosystem layers (pick one or all)
./install-ecosystem.sh skills
./install-ecosystem.sh plugins
./install-ecosystem.sh tools
./install-ecosystem.sh integrations
./install-ecosystem.sh multiagent
# ./install-ecosystem.sh all
Official docs: hermes-agent.nousresearch.com/docs
What's in this guide¶
| File | Purpose |
|---|---|
| TUTORIAL.md | Full install → skills → GUI → gateway → level-up |
| ECOSYSTEM.md | Curated catalog (online) |
verify-install.sh |
Health check after install |
install-starter-pack.sh |
Lightweight skills only (wondelai + litprog) |
install-ecosystem.sh |
Layered installer: skills, plugins, tools, integrations, multiagent |
.env.example |
Optional API key reference |
assets/hermes-ecosystem-workflow.{html,gif,png} |
Animated ecosystem diagram |
assets/render_diagrams.py |
Regenerate workflow GIF/PNG |
assets/blog-poster-1200x600.png |
1200×600 blog header image |
assets/render_blog_poster.py |
Regenerate poster from HTML |
Read the full tutorial →{ .md-button .md-button--primary } Browse ecosystem catalog →{ .md-button }