Hermes Agent 安装教程（Linux）

0. 前置：安装 Python

Hermes Agent 需要 Python 3.8+，建议使用 3.10+。

检查是否已安装：

python3 --version

如果看到版本号且 >= 3.8，可以跳过安装。

安装 Python：

# Ubuntu / Debian
sudo apt update && sudo apt install python3 python3-pip

# CentOS / RHEL
sudo yum install python3 python3-pip

# Arch
sudo pacman -S python python-pip

1. 安装 Hermes Agent

推荐方式：pipx（隔离安装，不污染全局环境）

pip3 install pipx
pipx ensurepath

重新打开终端后，执行：

pipx install hermes-agent

备选方式：pip

pip3 install hermes-agent

验证安装：

hermes --version

如果看到版本号，说明安装成功了。

2. 配置 Hermes（接入闪电API）

2.1 创建配置目录

mkdir -p ~/.hermes

2.2 写入配置文件

根据你要使用的模型类型，选择下面其中一种写法。

Claude / Anthropic（不带 /v1）：

cat > ~/.hermes/config.yaml << 'EOF'
models:
  default: flashapi-claude/claude-opus-4-6

providers:
  flashapi-claude:
    type: anthropic
    base_url: https://ai.flashapi.top
    api_key: 你的闪电API Key
    api_key_env: ANTHROPIC_API_KEY
    default_model: claude-opus-4-6
    models:
      - claude-opus-4-6
EOF

GPT / OpenAI（必须带 /v1）：

cat > ~/.hermes/config.yaml << 'EOF'
models:
  default: flashapi-codex/gpt-5.5

providers:
  flashapi-codex:
    type: openai
    base_url: https://ai.flashapi.top/v1
    api_key: 你的闪电API Key
    api_key_env: OPENAI_API_KEY
    default_model: gpt-5.5
    models:
      - gpt-5.5
EOF

必须替换：把 你的闪电API Key 替换成你从闪电API官网复制的真实 Key。

2.3 验证配置文件

cat ~/.hermes/config.yaml

3. 启动并验证

hermes

常见问题

1. 提示找不到 hermes 命令

原因：pipx 安装路径没有加到 PATH。

解决方法：

pipx ensurepath
source ~/.bashrc  # 或 source ~/.zshrc

2. pip3 提示 externally-managed-environment

这是 Python 3.11+ 的保护机制，推荐改用 pipx：

pip3 install pipx
pipx install hermes-agent

3. API 调用失败

1. 检查配置文件：cat ~/.hermes/config.yaml
2. 确认 API Key 正确，令牌分组已创建
3. 确认 Claude 接口不带 /v1，GPT 接口带 /v1