Hermes Agent 安装教程：Windows/Linux/macOS/WSL2 快速上手与避坑清单（2026最新）

想用Hermes Agent但不知道从哪开始？安装其实很简单，60秒就能跑起来。这篇讲清楚所有安装方式、最小配置、以及常见坑怎么避免。

安装要求

要求	最低	推荐
操作系统	Linux/macOS/WSL2	Ubuntu 22.04
Python	3.10+	3.11+
内存	4GB	8GB+
磁盘	2GB	10GB+
网络	能访问API	稳定

Windows用户建议用WSL2，macOS直接装，Linux最推荐。

方式一：自动安装（推荐）

curl -s https://hermes-agent.nousresearch.com/install.sh | sh

或者

wget -qO- https://hermes-agent.nousresearch.com/install.sh | sh

自动脚本会：

• 检查Python环境
• 安装依赖
• 配置初始化
• 创建配置目录

方式二：pip安装

pip install hermes-agent

或用uv（更快）：

uv pip install hermes-agent

方式三：从源码安装

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
uv pip install -e .

开发版，适合想看源码或贡献代码的人。

方式四：Docker安装

# 拉取镜像
docker pull nousresearch/hermes-agent:latest

# 运行
docker run -it --rm   -v ~/.hermes:/home/hermes/.hermes   -v ~/.ssh:/home/hermes/.ssh   nousresearch/hermes-agent:latest

Docker方式不需要本地Python环境，但需要注意卷挂载配置。

验证安装

hermes --version

看到版本号说明安装成功。

hermes doctor

诊断命令，检查环境配置是否正确。

配置API Key

Hermes需要连接AI模型才能工作。最简单的方式是配置OpenRouter：

# 注册 https://openrouter.ai
# 获取API Key

hermes config set OPENROUTER_API_KEY sk-or-xxx

或者直接编辑配置文件：

vi ~/.hermes/config.yaml

providers:
  openrouter:
    api_key: "sk-or-v1-xxx"
    default: true

models:
  default: "anthropic/claude-sonnet-4"

配置国内模型（可选）

如果想用国内模型（如DeepSeek、MiniMax），配置如下：

providers:
  deepseek:
    api_key: "sk-xxx"
    base_url: "https://api.deepseek.com/v1"

minimax:
    api_key: "eyJxxx"
    base_url: "https://api.minimax.chat/v1"

第一次对话

hermes chat

看到对话提示符后，直接问问题：

你好，帮我写一个Python函数判断质数

AI会回答。如果没反应，检查API Key是否配置正确。

WSL2特别说明

Windows上推荐用WSL2：

# 安装WSL2
wsl --install

# 进入Ubuntu
wsl

# 然后按Linux方式安装
curl -s https://hermes-agent.nousresearch.com/install.sh | sh

WSL2性能接近原生Linux，比虚拟机好很多。

配置国内镜像源

如果pip安装慢，换国内镜像：

pip install hermes-agent -i https://pypi.tuna.tsinghua.edu.cn/simple