awesome-hermes-agent-ecosystem

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Awesome Hermes Agent Ecosystem

优秀Hermes Agent生态系统

Skill by ara.so — AI Agent Skills collection.
This skill provides comprehensive knowledge of the Hermes Agent ecosystem maintained at 0xNyk/awesome-hermes-agent. Hermes Agent by Nous Research is a self-improving AI agent with built-in learning loop, autonomous skill curation, and 18-platform messaging support.
ara.so提供的Skill——AI Agent技能集合。
本Skill提供了由0xNyk/awesome-hermes-agent维护的Hermes Agent生态系统的全面知识。Nous Research开发的Hermes Agent是一款具备内置学习循环、自主技能管理以及支持18种平台消息功能的自我改进型AI Agent。

What is Hermes Agent?

什么是Hermes Agent?

Hermes Agent is the only agent with:
  • Built-in learning loop — creates skills from experience and improves them during use
  • Autonomous Curator (v0.12.0+) — maintains its own skill library with 7-day grade/consolidate/prune cycles
  • 18 messaging platforms — Telegram, Discord, Slack, WhatsApp, Signal, Feishu/Lark, WeCom, QQBot, Yuanbao, and more
  • 7 terminal backends — local, Docker, SSH, Singularity, Modal, Daytona, Vercel Sandbox
  • Conversational memory — searches past conversations and builds user model across sessions
Core repository: NousResearch/hermes-agent (134k+ stars)
Hermes Agent是唯一具备以下特性的Agent:
  • 内置学习循环——从经验中创建技能,并在使用过程中不断改进
  • 自主管理器(v0.12.0+)——通过7天的评级/整合/修剪周期维护自身技能库
  • 18种消息平台支持——Telegram、Discord、Slack、WhatsApp、Signal、飞书/Lark、企业微信、QQBot、元宝等
  • 7种终端后端——本地、Docker、SSH、Singularity、Modal、Daytona、Vercel Sandbox
  • 对话记忆——搜索过往对话,并跨会话构建用户模型
核心仓库:NousResearch/hermes-agent(134k+星标)

Quick Start Path

快速入门路径

1. Install Hermes Agent

1. 安装Hermes Agent

bash
undefined
bash
undefined

Clone the repository

Clone the repository

Install dependencies (Python 3.10+)

Install dependencies (Python 3.10+)

pip install -e .
pip install -e .

Configure API keys

Configure API keys

export ANTHROPIC_API_KEY="your_key_here"
export ANTHROPIC_API_KEY="your_key_here"

or use .env file

or use .env file

cp .env.example .env
undefined
cp .env.example .env
undefined

2. First Conversation

2. 首次对话

bash
undefined
bash
undefined

Start interactive CLI

Start interactive CLI

hermes
hermes

Or one-off command

Or one-off command

hermes "analyze this codebase and suggest improvements"
undefined
hermes "analyze this codebase and suggest improvements"
undefined

3. Add Your First Skills

3. 添加首个技能

Option A: Cross-platform skills (wondelai)
bash
undefined
选项A:跨平台技能(wondelai)
bash
undefined

Clone wondelai/skills (380+ stars, production-ready)

Clone wondelai/skills (380+ stars, production-ready)

cd ~/.hermes/skills git clone https://github.com/wondelai/skills.git wondelai
cd ~/.hermes/skills git clone https://github.com/wondelai/skills.git wondelai

Skills auto-discovered on next run

Skills auto-discovered on next run

hermes "use the youtube search skill to find videos about agent frameworks"

**Option B: Literate programming (litprog-skill)**
```bash
hermes "use the youtube search skill to find videos about agent frameworks"

**选项B:文学编程(litprog-skill)**
```bash

Clone litprog-skill for code + documentation workflows

Clone litprog-skill for code + documentation workflows

cd ~/.hermes/skills git clone https://github.com/tlehman/litprog-skill.git
cd ~/.hermes/skills git clone https://github.com/tlehman/litprog-skill.git

Use literate programming

Use literate programming

hermes "create a literate program that implements a binary tree"
undefined
hermes "create a literate program that implements a binary tree"
undefined

4. Add a GUI

4. 添加GUI界面

Option A: Hermes-native workspace
bash
undefined
选项A:Hermes原生工作区
bash
undefined

Clone hermes-workspace (500+ stars)

Clone hermes-workspace (500+ stars)

git clone https://github.com/outsourc-e/hermes-workspace.git cd hermes-workspace npm install npm run dev
git clone https://github.com/outsourc-e/hermes-workspace.git cd hermes-workspace npm install npm run dev

**Option B: Multi-agent orchestration**
```bash

**选项B:多Agent编排**
```bash

Clone mission-control (3.7k+ stars)

Clone mission-control (3.7k+ stars)

git clone https://github.com/builderz-labs/mission-control.git cd mission-control docker-compose up -d
git clone https://github.com/builderz-labs/mission-control.git cd mission-control docker-compose up -d
undefined
undefined

Key Configuration

关键配置

Profile System (Multi-Instance)

配置文件系统(多实例)

yaml
undefined
yaml
undefined

~/.hermes/profiles/work.yaml

~/.hermes/profiles/work.yaml

name: work messaging_platform: slack terminal_backend: docker model: claude-opus-4 memory: conversation_window: 50 auto_summarize: true

```bash
name: work messaging_platform: slack terminal_backend: docker model: claude-opus-4 memory: conversation_window: 50 auto_summarize: true

```bash

Use specific profile

Use specific profile

hermes --profile work "analyze the sales dashboard"
undefined
hermes --profile work "analyze the sales dashboard"
undefined

Cron Scheduling

定时任务调度

yaml
undefined
yaml
undefined

~/.hermes/cron.yaml

~/.hermes/cron.yaml

jobs:
  • name: daily-standup schedule: "0 9 * * 1-5" # 9 AM weekdays command: "summarize yesterday's commits and create standup report"
  • name: skill-curator schedule: "0 2 * * 0" # 2 AM Sundays command: "hermes curator --grade --consolidate --prune"
undefined
jobs:
  • name: daily-standup schedule: "0 9 * * 1-5" # 工作日上午9点 command: "summarize yesterday's commits and create standup report"
  • name: skill-curator schedule: "0 2 * * 0" # 周日凌晨2点 command: "hermes curator --grade --consolidate --prune"
undefined

Messaging Gateway Setup

消息网关设置

bash
undefined
bash
undefined

Telegram

Telegram

export TELEGRAM_BOT_TOKEN="your_token" hermes --messaging telegram
export TELEGRAM_BOT_TOKEN="your_token" hermes --messaging telegram

Discord

Discord

export DISCORD_BOT_TOKEN="your_token" hermes --messaging discord
export DISCORD_BOT_TOKEN="your_token" hermes --messaging discord

Slack

Slack

export SLACK_BOT_TOKEN="xoxb-your-token" export SLACK_APP_TOKEN="xapp-your-token" hermes --messaging slack
undefined
export SLACK_BOT_TOKEN="xoxb-your-token" export SLACK_APP_TOKEN="xapp-your-token" hermes --messaging slack
undefined

Essential Skills & Plugins

核心技能与插件

Goal Management & Cost Control

目标管理与成本控制

bash
undefined
bash
undefined

Install hermes-plugins (42-evey)

Install hermes-plugins (42-evey)

cd ~/.hermes/skills git clone https://github.com/42-evey/hermes-plugins.git
cd ~/.hermes/skills git clone https://github.com/42-evey/hermes-plugins.git

Usage examples

Usage examples

hermes "set a goal to refactor the authentication module by Friday" hermes "show me this week's API cost breakdown by model" hermes "switch to claude-sonnet for this task to save costs"
undefined
hermes "set a goal to refactor the authentication module by Friday" hermes "show me this week's API cost breakdown by model" hermes "switch to claude-sonnet for this task to save costs"
undefined

Inter-Agent Communication

Agent间通信

bash
undefined
bash
undefined

Using hermes-plugins inter-agent bridge

Using hermes-plugins inter-agent bridge

Terminal 1: Agent A

Terminal 1: Agent A

hermes --profile researcher --port 8001
hermes --profile researcher --port 8001

Terminal 2: Agent B

Terminal 2: Agent B

hermes --profile writer --port 8002
hermes --profile writer --port 8002

Agent A to Agent B

Agent A to Agent B

hermes "send to writer agent: use this research summary to write a blog post"
undefined
hermes "send to writer agent: use this research summary to write a blog post"
undefined

Incident Response (SRE)

事件响应(SRE)

bash
undefined
bash
undefined

Install hermes-incident-commander

Install hermes-incident-commander

Cron-based monitoring

Cron-based monitoring

hermes "monitor production services and alert on failures"
hermes "monitor production services and alert on failures"

Manual incident handling

Manual incident handling

hermes "diagnose why the API is returning 503 errors and apply a fix"
undefined
hermes "diagnose why the API is returning 503 errors and apply a fix"
undefined

Spotify Control (Linux/Raspberry Pi)

Spotify控制(Linux/树莓派)

bash
undefined
bash
undefined

Install hermes-spotify-skill (Linux-native)

Install hermes-spotify-skill (Linux-native)

Configure Spotify credentials

Configure Spotify credentials

export SPOTIPY_CLIENT_ID="your_client_id" export SPOTIPY_CLIENT_SECRET="your_client_secret" export SPOTIPY_REDIRECT_URI="http://localhost:8888/callback"
export SPOTIPY_CLIENT_ID="your_client_id" export SPOTIPY_CLIENT_SECRET="your_client_secret" export SPOTIPY_REDIRECT_URI="http://localhost:8888/callback"

Usage

Usage

hermes "play lo-fi hip hop on Spotify" hermes "skip to the next track" hermes "transfer playback to my Raspberry Pi speaker"
undefined
hermes "play lo-fi hip hop on Spotify" hermes "skip to the next track" hermes "transfer playback to my Raspberry Pi speaker"
undefined

Self-Hosted Cloud Integration (Nextcloud)

自建云集成(Nextcloud)

bash
undefined
bash
undefined

Install hermes-nextcloud

Install hermes-nextcloud

Configure

Configure

export NEXTCLOUD_URL="https://your-nextcloud.example.com" export NEXTCLOUD_USERNAME="your_username" export NEXTCLOUD_APP_PASSWORD="your_app_password"
export NEXTCLOUD_URL="https://your-nextcloud.example.com" export NEXTCLOUD_USERNAME="your_username" export NEXTCLOUD_APP_PASSWORD="your_app_password"

Usage

Usage

hermes "list my nextcloud files" hermes "create a note about today's meeting in nextcloud" hermes "show my calendar for next week"
undefined
hermes "list my nextcloud files" hermes "create a note about today's meeting in nextcloud" hermes "show my calendar for next week"
undefined

Deployment Patterns

部署模式

Production VPS Deployment

生产环境VPS部署

bash
undefined
bash
undefined

Systemd service

Systemd service

cat > /etc/systemd/system/hermes.service <<EOF [Unit] Description=Hermes Agent After=network.target
[Service] Type=simple User=hermes WorkingDirectory=/opt/hermes-agent Environment="ANTHROPIC_API_KEY=your_key" ExecStart=/usr/bin/hermes --messaging telegram --profile production Restart=always
[Install] WantedBy=multi-user.target EOF
sudo systemctl enable hermes sudo systemctl start hermes
undefined
cat > /etc/systemd/system/hermes.service <<EOF [Unit] Description=Hermes Agent After=network.target
[Service] Type=simple User=hermes WorkingDirectory=/opt/hermes-agent Environment="ANTHROPIC_API_KEY=your_key" ExecStart=/usr/bin/hermes --messaging telegram --profile production Restart=always
[Install] WantedBy=multi-user.target EOF
sudo systemctl enable hermes sudo systemctl start hermes
undefined

Docker Deployment

Docker部署

dockerfile
undefined
dockerfile
undefined

Dockerfile

Dockerfile

FROM python:3.11-slim
WORKDIR /app COPY . . RUN pip install -e .
ENV ANTHROPIC_API_KEY="" ENV TELEGRAM_BOT_TOKEN=""
CMD ["hermes", "--messaging", "telegram"]

```bash
FROM python:3.11-slim
WORKDIR /app COPY . . RUN pip install -e .
ENV ANTHROPIC_API_KEY="" ENV TELEGRAM_BOT_TOKEN=""
CMD ["hermes", "--messaging", "telegram"]

```bash

Build and run

Build and run

docker build -t hermes-agent . docker run -d
-e ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY"
-e TELEGRAM_BOT_TOKEN="$TELEGRAM_BOT_TOKEN"
-v ~/.hermes:/root/.hermes
--name hermes
hermes-agent
undefined
docker build -t hermes-agent . docker run -d
-e ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY"
-e TELEGRAM_BOT_TOKEN="$TELEGRAM_BOT_TOKEN"
-v ~/.hermes:/root/.hermes
--name hermes
hermes-agent
undefined

Vercel Sandbox Deployment

Vercel Sandbox部署

bash
undefined
bash
undefined

Use Vercel Sandbox backend (serverless)

Use Vercel Sandbox backend (serverless)

hermes --terminal vercel-sandbox "deploy this Next.js app"
undefined
hermes --terminal vercel-sandbox "deploy this Next.js app"
undefined

Modal Deployment (Serverless GPU)

Modal部署(无服务器GPU)

bash
undefined
bash
undefined

Use Modal for GPU-intensive tasks

Use Modal for GPU-intensive tasks

hermes --terminal modal "train this model on the full dataset"
undefined
hermes --terminal modal "train this model on the full dataset"
undefined

Multi-Agent Orchestration

多Agent编排

Using oh-my-hermes Suite

使用oh-my-hermes套件

bash
undefined
bash
undefined

Install oh-my-hermes (witt3rd)

Install oh-my-hermes (witt3rd)

cd ~/.hermes/skills git clone https://github.com/witt3rd/oh-my-hermes.git
cd ~/.hermes/skills git clone https://github.com/witt3rd/oh-my-hermes.git

Deep research workflow

Deep research workflow

hermes "research the state of agent frameworks using deep-research skill"
hermes "research the state of agent frameworks using deep-research skill"

Consensus planning (Planner → Architect → Critic)

Consensus planning (Planner → Architect → Critic)

hermes "create a ralplan for building a distributed task queue"
hermes "create a ralplan for building a distributed task queue"

Verified execution (execute → verify → iterate)

Verified execution (execute → verify → iterate)

hermes "implement the task queue using ralph skill"
hermes "implement the task queue using ralph skill"

Full autopilot

Full autopilot

hermes "autopilot: research agent frameworks, plan architecture, implement MVP"
undefined
hermes "autopilot: research agent frameworks, plan architecture, implement MVP"
undefined

Inter-Agent Bridge Pattern

Agent间桥接模式

python
undefined
python
undefined

In agent A's skill

In agent A's skill

def send_to_agent(target_agent: str, message: str, port: int): """Send message to another Hermes instance""" import requests
response = requests.post(
    f"http://localhost:{port}/api/message",
    json={"message": message}
)
return response.json()
def send_to_agent(target_agent: str, message: str, port: int): """Send message to another Hermes instance""" import requests
response = requests.post(
    f"http://localhost:{port}/api/message",
    json={"message": message}
)
return response.json()

Usage

Usage

send_to_agent("writer", "Use this data to write a report", port=8002)
undefined
send_to_agent("writer", "Use this data to write a report", port=8002)
undefined

MCP (Model Context Protocol) Integration

MCP(模型上下文协议)集成

bash
undefined
bash
undefined

List available MCP servers

List available MCP servers

hermes "list mcp servers"
hermes "list mcp servers"

Use MCP server

Use MCP server

hermes "use the filesystem MCP server to read project files"
hermes "use the filesystem MCP server to read project files"

Configure custom MCP server

Configure custom MCP server

cat > ~/.hermes/mcp-servers.json <<EOF { "servers": { "custom-db": { "command": "node", "args": ["/path/to/db-mcp-server/index.js"], "env": { "DB_CONNECTION_STRING": "postgresql://..." } } } } EOF
undefined
cat > ~/.hermes/mcp-servers.json <<EOF { "servers": { "custom-db": { "command": "node", "args": ["/path/to/db-mcp-server/index.js"], "env": { "DB_CONNECTION_STRING": "postgresql://..." } } } } EOF
undefined

Memory System

记忆系统

Conversational Memory

对话记忆

bash
undefined
bash
undefined

Search past conversations

Search past conversations

hermes "what did we discuss about authentication last week?"
hermes "what did we discuss about authentication last week?"

Summarize conversation history

Summarize conversation history

hermes "summarize all our discussions about the API redesign"
undefined
hermes "summarize all our discussions about the API redesign"
undefined

Skill Memory

技能记忆

bash
undefined
bash
undefined

Skills automatically improve from experience

Skills automatically improve from experience

After using a skill multiple times:

After using a skill multiple times:

hermes "show me how the 'api-integration' skill has evolved"
hermes "show me how the 'api-integration' skill has evolved"

Curator grades skills automatically (v0.12.0+)

Curator grades skills automatically (v0.12.0+)

hermes curator --report
undefined
hermes curator --report
undefined

Advanced Patterns

进阶模式

Self-Improving Skill Factory

自我改进技能工厂

bash
undefined
bash
undefined

Install hermes-skill-factory

Install hermes-skill-factory

Auto-generate skill from workflow

Auto-generate skill from workflow

hermes "watch me deploy this app, then create a reusable deployment skill"
undefined
hermes "watch me deploy this app, then create a reusable deployment skill"
undefined

Personal Obsidian API

个人Obsidian API

bash
undefined
bash
undefined

Install personal-api skill

Install personal-api skill

Point to your Obsidian vault

Point to your Obsidian vault

export OBSIDIAN_VAULT_PATH="$HOME/Documents/Obsidian"
export OBSIDIAN_VAULT_PATH="$HOME/Documents/Obsidian"

Usage

Usage

hermes "read my daily notes and suggest priorities" hermes "what did I write about agent frameworks?"
undefined
hermes "read my daily notes and suggest priorities" hermes "what did I write about agent frameworks?"
undefined

Accumulator Betting Tracker

累积投注追踪器

bash
undefined
bash
undefined

Install acca-tracker (sports betting multi-leg tracking)

Install acca-tracker (sports betting multi-leg tracking)

cd ~/.hermes/skills git clone https://github.com/svenmedina07-ship-it/skills.git cd skills/acca-tracker
cd ~/.hermes/skills git clone https://github.com/svenmedina07-ship-it/skills.git cd skills/acca-tracker

Configure cron for 15-minute updates

Configure cron for 15-minute updates

hermes "set up acca tracking cron job"
hermes "set up acca tracking cron job"

Manual check

Manual check

hermes "check my accumulator bet status"
undefined
hermes "check my accumulator bet status"
undefined

API Server Mode

API服务器模式

bash
undefined
bash
undefined

Start Hermes as API server

Start Hermes as API server

hermes serve --port 8080
hermes serve --port 8080

Use REST API

Use REST API

curl -X POST http://localhost:8080/api/chat
-H "Content-Type: application/json"
-d '{"message": "analyze this code", "context": {"file": "main.py"}}'

```python
curl -X POST http://localhost:8080/api/chat
-H "Content-Type: application/json"
-d '{"message": "analyze this code", "context": {"file": "main.py"}}'

```python

Python client

Python client

import requests
def ask_hermes(message: str, context: dict = None): response = requests.post( "http://localhost:8080/api/chat", json={"message": message, "context": context or {}} ) return response.json()["response"]
import requests
def ask_hermes(message: str, context: dict = None): response = requests.post( "http://localhost:8080/api/chat", json={"message": message, "context": context or {}} ) return response.json()["response"]

Usage

Usage

result = ask_hermes("refactor this function", context={"file": "utils.py"})
undefined
result = ask_hermes("refactor this function", context={"file": "utils.py"})
undefined

Troubleshooting

故障排除

Skills Not Loading

技能未加载

bash
undefined
bash
undefined

Check skills directory

Check skills directory

ls -la ~/.hermes/skills/
ls -la ~/.hermes/skills/

Verify skill structure (needs skill.md or SKILL.md)

Verify skill structure (needs skill.md or SKILL.md)

cat ~/.hermes/skills/your-skill/skill.md
cat ~/.hermes/skills/your-skill/skill.md

Force reload

Force reload

hermes --reload-skills "list available skills"
undefined
hermes --reload-skills "list available skills"
undefined

Memory Issues

记忆问题

bash
undefined
bash
undefined

Clear conversation history

Clear conversation history

hermes clear-history
hermes clear-history

Reduce memory window in profile

Reduce memory window in profile

~/.hermes/profiles/default.yaml

~/.hermes/profiles/default.yaml

memory: conversation_window: 20 # Reduce from default 50
undefined
memory: conversation_window: 20 # Reduce from default 50
undefined

Curator Failures

管理器故障

bash
undefined
bash
undefined

Manual curator run with debug

Manual curator run with debug

hermes curator --grade --verbose
hermes curator --grade --verbose

Skip consolidation if stuck

Skip consolidation if stuck

hermes curator --grade --prune --skip-consolidate
hermes curator --grade --prune --skip-consolidate

Reset curator state

Reset curator state

rm ~/.hermes/curator/state.json
undefined
rm ~/.hermes/curator/state.json
undefined

Messaging Gateway Issues

消息网关问题

bash
undefined
bash
undefined

Test connection

Test connection

hermes --messaging telegram --test-connection
hermes --messaging telegram --test-connection

Debug webhook (for platforms like Telegram)

Debug webhook (for platforms like Telegram)

export HERMES_WEBHOOK_URL="https://your-domain.com/webhook" hermes --messaging telegram --debug
undefined
export HERMES_WEBHOOK_URL="https://your-domain.com/webhook" hermes --messaging telegram --debug
undefined

Terminal Backend Failures

终端后端故障

bash
undefined
bash
undefined

Test Docker backend

Test Docker backend

docker ps # Ensure Docker is running hermes --terminal docker "echo test"
docker ps # Ensure Docker is running hermes --terminal docker "echo test"

Fallback to local execution

Fallback to local execution

hermes --terminal local "echo test"
hermes --terminal local "echo test"

SSH backend with custom key

SSH backend with custom key

hermes --terminal ssh
--ssh-host "192.168.1.100"
--ssh-user "ubuntu"
--ssh-key "~/.ssh/hermes_key"
undefined
hermes --terminal ssh
--ssh-host "192.168.1.100"
--ssh-user "ubuntu"
--ssh-key "~/.ssh/hermes_key"
undefined

Common Workflows

常见工作流

Daily Standup Automation

每日站会自动化

yaml
undefined
yaml
undefined

~/.hermes/cron.yaml

~/.hermes/cron.yaml

jobs:
  • name: daily-standup schedule: "0 9 * * 1-5" command: | summarize yesterday's git commits, check open GitHub issues assigned to me, create standup report and post to #standup Slack channel
undefined
jobs:
  • name: daily-standup schedule: "0 9 * * 1-5" command: | summarize yesterday's git commits, check open GitHub issues assigned to me, create standup report and post to #standup Slack channel
undefined

Code Review Assistant

代码审查助手

bash
undefined
bash
undefined

Review pull request

Review pull request

hermes "review PR #123 on GitHub and provide feedback"
hermes "review PR #123 on GitHub and provide feedback"

Continuous code quality

Continuous code quality

hermes "monitor the main branch and flag potential issues after each push"
undefined
hermes "monitor the main branch and flag potential issues after each push"
undefined

Documentation Generator

文档生成器

bash
undefined
bash
undefined

Generate docs from code

Generate docs from code

hermes "analyze src/ and generate API documentation in docs/"
hermes "analyze src/ and generate API documentation in docs/"

Keep docs in sync

Keep docs in sync

hermes "watch src/ and update docs/ whenever code changes"
undefined
hermes "watch src/ and update docs/ whenever code changes"
undefined

Ecosystem Resources

生态系统资源

Maturity Tags

成熟度标签

When exploring the ecosystem, note these maturity indicators:
  • production — Stable, documented, actively maintained
  • beta — Works but evolving, expect some rough edges
  • experimental — Proof of concept, learn from it but don't depend on it
探索生态系统时,请注意以下成熟度指标:
  • production — 稳定、文档完善、持续维护
  • beta — 可正常使用但仍在演进,可能存在一些不完善之处
  • experimental — 概念验证,可参考学习但不建议用于生产环境

Getting Help

获取帮助

bash
undefined
bash
undefined

Built-in help

Built-in help

hermes --help
hermes --help

Skill-specific help

Skill-specific help

hermes "explain the youtube-search skill"
hermes "explain the youtube-search skill"

Community support

Community support

Post in Discord #hermes-agent channel with:

Post in Discord #hermes-agent channel with:

hermes "generate a debug report" > debug.txt
undefined
hermes "generate a debug report" > debug.txt
undefined