Hermes Agent 多智能体集群部署完全指南

# Ubuntu/Debian
sudo apt update && sudo apt upgrade -y
sudo apt install git -y

# 验证安装
git --version

# 1. Git 镜像加速
git config --global url."https://mirror.ghproxy.com/https://github.com".insteadOf "https://github.com"

# 2. pip 阿里云镜像
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

# 3. npm 腾讯云镜像
npm config set registry https://mirrors.cloud.tencent.com/npm/ --global

sudo ufw allow 3000/tcp
sudo ufw allow 6060/tcp
sudo ufw reload

# 国内环境推荐（镜像加速）
curl -fsSL https://hermes.xaapi.ai/install.sh | bash

# 官方原版（国外环境）
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 1. 安装 Docker
sudo apt install docker.io -y
sudo systemctl start docker
sudo systemctl enable docker

# 2. 拉取官方镜像
docker pull nousresearch/hermes-agent:latest

# 3. 创建配置目录并启动
mkdir -p ~/.hermes/docker-config
docker run -d \
  --name hermes-agent \
  -v ~/.hermes/docker-config:/root/.hermes \
  -p 8080:8080 \
  nousresearch/hermes-agent:latest

# 4. 验证运行状态
docker ps | grep hermes-agent

# 刷新环境变量
source ~/.bashrc  # bash 用户
source ~/.zshrc   # zsh 用户

# 验证版本
hermes --version
# 预期输出：hermes v0.14.0

# 健康检查
hermes doctor
# 所有核心项显示 green 即为正常

hermes setup

# 编辑环境变量文件
vim ~/.hermes/.env

# 添加 Kimi API Key
MOONSHOT_API_KEY=sk-your-kimi-api-key-here

# 编辑主配置文件
vim ~/.hermes/config.yaml

# 设置默认模型
default_model: moonshot/kimi-latest
model_providers:
  moonshot:
    api_key: "${MOONSHOT_API_KEY}"
    base_url: "https://api.moonshot.cn/v1"
    timeout: 60

# .env 文件
DASHSCOPE_API_KEY=sk-your-dashscope-key

# config.yaml
default_model: qwen/qwen-plus
model_providers:
  qwen:
    api_key: "${DASHSCOPE_API_KEY}"
    base_url: "https://dashscope.aliyuncs.com/compatible-mode/v1"

# .env 文件
OPENROUTER_API_KEY=sk-your-openrouter-key

# config.yaml
default_model: openrouter/claude-3-haiku
model_providers:
  openrouter:
    api_key: "${OPENROUTER_API_KEY}"
    base_url: "https://openrouter.ai/api/v1"

# 列出可用模型
hermes model list

# 测试对话
hermes -m "你好，请介绍一下自己"

# 开启常用工具
hermes tools enable file shell browser

# 查看已开启工具
hermes tools list

# 禁用不需要的工具
hermes tools disable docker ssh

# 创建三个 profile，分别用于不同角色
hermes profile create programmer --clone
hermes profile create researcher --clone
hermes profile create designer --clone

# 创建结果，以 'programmer' 为例
Profile 'programmer' created at /root/.hermes/profiles/programmer
Cloned config, .env, SOUL.md, and skills from default.
0 bundled skills synced.
Wrapper created: /root/.local/bin/programmer

Next steps:
  programmer setup              Configure API keys and model
  programmer chat               Start chatting
  programmer gateway start      Start the messaging gateway

  Edit ~/.hermes/profiles/programmer/.env for different API keys
  Edit ~/.hermes/profiles/programmer/SOUL.md for different personality

# 查看所有 profile
hermes profile list

# 为 programmer profile 配置
hermes -p programmer setup

# 为 researcher profile 配置（可使用不同模型）
hermes -p researcher setup

# 为 designer profile 配置
hermes -p designer setup

# 切换到指定 profile
hermes profile use programmer

# 或单次命令指定 profile
hermes -p programmer -m "帮我写一个 Python 脚本"
hermes -p researcher -m "帮我研究最新的 AI 论文"

~/.hermes/
├── config.yaml              # 全局共享配置
├── .env                     # 全局共享密钥
└── profiles/
    ├── programmer/          # 程序员实例
    │   ├── memories/        # 独立记忆库
    │   ├── skills/          # 独立技能库
    │   └── .env             # 可选：实例级密钥
    ├── researcher/          # 研究员实例
    └── designer/            # 设计师实例

# 创建独立的 home 目录
mkdir -p ~/.hermes-instance-{programmer,researcher,designer}

# 为每个实例初始化配置
export HERMES_HOME=~/.hermes-instance-programmer
hermes setup

export HERMES_HOME=~/.hermes-instance-researcher
hermes setup

export HERMES_HOME=~/.hermes-instance-designer
hermes setup

# 启动多个容器实例
docker run -d \
  --name hermes-programmer \
  -v ~/.hermes-programmer:/root/.hermes \
  -p 8081:8080 \
  nousresearch/hermes-agent:latest

docker run -d \
  --name hermes-researcher \
  -v ~/.hermes-researcher:/root/.hermes \
  -p 8082:8080 \
  nousresearch/hermes-agent:latest

docker run -d \
  --name hermes-designer \
  -v ~/.hermes-designer:/root/.hermes \
  -p 8083:8080 \
  nousresearch/hermes-agent:latest

# 为特定 profile 配置 gateway
hermes -p programmer gateway setup

# 启动不同实例的 gateway
hermes -p programmer gateway run   # 终端1
hermes -p researcher gateway run   # 终端2
hermes -p designer gateway run     # 终端3

sudo nano /etc/systemd/system/hermes-gateway@.service

[Unit]
Description=Hermes Gateway Instance %i
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=root
WorkingDirectory=/home/hermes
Environment="PATH=/root/.local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
ExecStart=/root/.local/bin/hermes -p %i gateway run
Restart=always
RestartSec=10
StandardOutput=journal
StandardError=journal
SyslogIdentifier=hermes-gateway-%i

# 可选资源限制
MemoryMax=2G
CPUQuota=200%

[Install]
WantedBy=multi-user.target

# 重载 systemd 配置
sudo systemctl daemon-reload

# 启动所有实例
sudo systemctl enable --now hermes-gateway@programmer.service
sudo systemctl enable --now hermes-gateway@researcher.service
sudo systemctl enable --now hermes-gateway@designer.service

# 批量启动
sudo systemctl enable --now hermes-gateway@{programmer,researcher,designer}.service

version: '3.8'
services:
  hermes-agent:
    image: nousresearch/hermes-agent:latest
    container_name: hermes-agent
    volumes:
      - ./config:/home/agent/.hermes
      - ./data:/opt/hermes
    environment:
      - HERMES_HOME=/home/agent/.hermes
    stdin_open: true
    tty: true
    restart: unless-stopped

  hermes-webui:
    image: lingganwu/hermes-web-ui
    container_name: hermes-webui
    ports:
      - "6060:6060"
    depends_on:
      - hermes-agent
    volumes:
      - ./config:/home/agent/.hermes
      - ./data/webui:/app/dist/data
    environment:
      - PORT=6060
      - UPSTREAM=http://hermes-agent:8642
      - HERMES_HOME=/home/agent/.hermes
    restart: unless-stopped

mkdir -p hermes_deploy/{config,data,logs}
docker-compose up -d

http://你的服务器IP:6060

docker logs -f hermes-webui | grep -i auth

# ~/.hermes/skills/custom_skill.md

# 技能名称：代码审查助手
## 触发条件
用户请求"review代码"或"帮我审查"

## 执行步骤
1. 读取目标代码文件
2. 分析代码质量问题
3. 输出改进建议列表

## 示例
用户：帮我审查 app.py
助手：正在审查代码...

memory:
  short_term:
    capacity: 10      # 保留最近10轮对话
    decay_rate: 0.8
  long_term:
    user_profile_path: "./data/profile.json"
    skill_graph_path: "./data/skill_graph.db"

# config.yaml
server:
  max_concurrent: 30      # 最大并发数
  request_timeout: 300    # 请求超时（秒）

# 启用缓存
CACHE_ENABLED=true

# 调整日志级别（生产环境）
LOG_LEVEL=info

# config.yaml
model_routing:
  coding: openrouter/claude-3.5-sonnet
  research: moonshot/kimi-latest
  chat: qwen/qwen-plus

# 检查 Git 镜像配置
git config --global --get-regexp url

# 如果仍有问题，手动克隆
git clone https://mirror.ghproxy.com/https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
bash scripts/install.sh

# 刷新环境变量
source ~/.bashrc

# 或手动添加 PATH
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# 检查 .env 文件
cat ~/.hermes/.env

# 验证 API Key（以 Kimi 为例）
curl -X POST https://api.moonshot.cn/v1/chat/completions \
  -H "Authorization: Bearer $MOONSHOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"moonshot-v1-8k","messages":[{"role":"user","content":"hi"}]}'

# 1. 检查 Gateway 状态
hermes -p [profile] gateway status

# 2. 查看日志
journalctl -u hermes-gateway@[profile].service -f

# 3. 验证 Bot Token（以 Telegram 为例）
curl "https://api.telegram.org/bot<YOUR_TOKEN>/getMe"

# 创建或编辑 ~/.hermes/profiles/programmer/.env
echo 'TERMINAL_DOCKER_EXTRA_ARGS=["-p", "20980:8080", "-p", "20173:5173"]' >> ~/.hermes/profiles/programmer/.env

# 查看确认
cat ~/.hermes/profiles/programmer/.env

# 1. 配置 swap 交换分区
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# 2. 在 systemd 服务中限制内存
# 见第 8 节配置文件中的 MemoryMax=2G