从零开始部署 Hermes Agent：你的第一个会"自我进化"的 AI

本教程面向零基础用户，涵盖环境检查、安装配置、模型接入与网关设置完整流程。按步骤操作完成后，你将得到一个具备自主学习能力的专属 AI 智能体——它会随着使用逐渐沉淀经验、提升效率，而非只能给出固定回复。

一、关于 Hermes Agent

由 Nous Research 于 2026 年 2 月开源（MIT 协议，当前版本 v0.13.0），采用 Python 开发。核心亮点在于自主学习能力：执行任务时自动总结方法、积累技能，用得越久，处理效率越高。

二、部署前检查清单

在开始之前，请确认你的环境满足以下条件：

硬件配置

• 最低：x86_64/ARM64 CPU、256MB 内存、100MB 磁盘空间、稳定网络
• 推荐：2 核 CPU、2GB 内存、1GB 磁盘空间、10Mbps 以上带宽

系统支持

• Windows 10 2004 / Windows 11（必须启用 WSL2，WSL1 无法运行）
• macOS 12 Monterey 及以上（Intel 和 Apple Silicon 均可）
• Linux：Ubuntu 20.04+、Debian 11+、CentOS 8+、Fedora 36+

还需要准备

1. 大模型 API 密钥：至少一个主流模型 Key。国内网络环境下，Kimi作为优选大模型提供商——连接稳定、处理速度快、性价比突出
2. 网络畅通：能正常访问 GitHub 和 PyPI。国内建议提前配置清华 PyPI 镜像，避免下载卡顿
3. 管理员权限：Linux / WSL2 需要 sudo；Windows 开启 WSL2 功能需管理员账户

三、安装hermes agent

1.1 Windows详细安装教程

方式一：WSL2 安装（推荐新手使用）

• 检查 Windows 版本：WSL2 需要 Windows 10（版本 2004 或更高）或 Windows 11。
• 选择终端 (管理员) 或 Windows PowerShell (管理员)，在 UAC 弹窗点击 “是”。
• 安装 WSL2，在 PowerShell 里输入这条命令，然后按回车：
  wsl --install
  注意：等待安装完成，可能需要几分钟。完成后会提示你重启电脑。
• 重启后设置 Linux 用户名和密码
• 在 WSL2 里安装 Hermes Agent，现在你已经在 Ubuntu 里了，输入这条命令：
  curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
  等几分钟，安装完成后输入：
  source ~/.bashrc
  hermes
  看到欢迎界面就成功了！

方式二：PowerShell 原生安装

• 打开 PowerShell：按 Win 键，输入 PowerShell，点击"Windows PowerShell"。（这次不需要管理员权限）
• 运行安装命令，复制下面这行，粘贴到 PowerShell 里，按回车：
  irm https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
• 等待安装完成：安装过程可能需要 3-5 分钟，期间会自动下载 Python、Node.js 等依赖。看到"Installation complete"就成功了。

1.2 macOS 详细安装教程

• 克隆项目到本地
  git clone https://gitcode.com/GitHub_Trending/he/hermes-agent.git

• 将下面代码复制到安装目录

  mkdir -p ~/.hermes
  cp -r ~/hermes-agent ~/.hermes/hermes-agent

• 进入目录并执行安装脚本
  cd ~/.hermes/hermes-agent && bash scripts/install.sh

• 重载环境变量
  Zsh 用户执行source ~/.zshrc
  Bash 用户执行（二选一）# source ~/.bashrc

1.3 Linux 详细安装教程

• 克隆项目到本地
  git clone https://gitcode.com/GitHub_Trending/he/hermes-agent.git

• 将下面代码复制到安装目录

  mkdir -p ~/.hermes
  cp -r ~/hermes-agent ~/.hermes/hermes-agent

• 进入目录并执行安装脚本
  cd ~/.hermes/hermes-agent && bash scripts/install.sh

• 重载环境变量
  source ~/.zshrc

四、向导配置教程

安装完成后，运行hermes命令，你会看到一个配置向导界面。输入1并按回车，进入快速设置模式。

1、选择模型提供商

在这一步内，可以选择你想使用的 AI 模型提供商。

新手推荐：

• 国内用户：选Kimi，适合国内用户，网络流畅稳定，处理效率拉满，高性价比优质之选

2、输入 API 密钥

选择提供商后，系统会提示你输入 API 密钥，以Kimi提供商为例展示获取方式：

• 登录Kimi网站获取API Key，访问 https://platform.moonshot.cn/console 点击登录

• 点击左侧的API Key管理，创建API Key，复制弹出的密钥字符
  

• 回到hermes agent继续配置

3、选择默认模型

将复制的API Key贴入终端并敲击回车，然后选择Moonshot/Kimi-K2.6模型并敲击回车确认。

4、配置工具

接下来会询问你想启用哪些工具。新手建议先启用基础工具：
web # 网络搜索和网页提取
terminal # 执行命令
file # 读写文件
browser # 浏览器自动化（可选）

5、配置完成

全部配置完成后，就可以开始对话啦~

五、常见问题及解决办法

1、环境准备类问题（Windows 用户高发）

Windows 直接安装失败（未用 WSL2）

• 错误表现：安装脚本报错、命令无法执行、界面无响应
• 核心原因：Hermes Agent 仅支持 Linux/macOS/WSL2，不支持 Windows 原生 PowerShell/CMD
• 解决方案：
  以管理员身份运行PowerShell，启用WSL2
  wsl --install -d Ubuntu
  安装后设置默认启动WSL
  wsl --set-default Ubuntu

2、网络与资源下载问题（国内用户常见）

官方脚本下载失败（GitHub 访问受限）

• 错误表现：curl: (7) Failed to connect to raw.githubusercontent.com
• 核心原因：国内网络无法直接访问 GitHub 资源
• 解决方案：

方法 1（推荐）：使用离线安装包

cd /mnt/d/Downloads  # 进入安装包目录sudo apt install -y unzipunzip hermes-agent-2026.4.8.zip
cd hermes-agent && bash install.sh

方法 2：配置代理后重试

export http_proxy=http://代理地址:端口
export https_proxy=http://代理地址:端口
`curl -sSL https://get.hermesagent.com | bash`

Python 依赖安装超时（PyPI 访问慢）

• 错误表现：pip install长时间卡住、ReadTimeoutError
• 解决方案：使用国内镜像源加速
  pip install --trusted-host pypi.tuna.tsinghua.edu.cn -i https://pypi.tuna.tsinghua.edu.cn/simple/ 依赖包名

3、命令与环境变量问题

hermes: command not found（安装后无法识别命令）

• 错误表现：终端输入hermes提示未找到命令

• 核心原因：环境变量未加载或 PATH 未更新

• 解决方案：

  重新加载环境变量source ~/.bashrc # 或~/.zshrc（根据Shell类型）# 或直接重启终端
  版本不匹配（Python/Node.js 版本冲突）

• Python 问题：Python 3.9 or older in PATH，安装器需要 Python 3.11

手动创建虚拟环境并指定版本
python3.11 -m venv hermes-venv
source hermes-venv/bin/activate

• Node.js 问题：ENOENT/EACCES错误，Node.js 安装不完整

  删除残留文件并重新安装rm -rf ~/.nvm ~/.node-gyp
  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
  nvm install 18

4、依赖冲突与缺失问题

Pydantic 版本冲突

• 错误表现：TypeError: BaseModel.validate() takes 1 positional argument but 2 were given

• 核心原因：Hermes 依赖 Pydantic v1，系统安装了 v2（语法不兼容）

• 解决方案：

  pip uninstall -y pydantic pydantic-core
  pip install pydantic==1.10.13

六、结语

Hermes Agent 部署完毕并正常投产，全流程本地化搭建完成，核心组件运行无忧。这款源自 Nous Research 的智能体框架，支持任务驱动自主进化，场景适配性极强，还能在实操中自主积累经验、优化能力，精准贴合使用需求。即刻开启使用，依靠多工具协作与自主学习，轻松高效完成各类工作任务。