Windows本地部署Hermes Agent实录！WSL+Python部署路线详细步骤

一、Hermes安装

1. 截至目前，Hermes官方明确说明”Native Windows is not supported“，因此Win系统使用Hermes必须安装WSL和Linux发行版：

wsl --install -d Ubuntu

2. Hermes是Python项目，后续需要用到python包管理器uv，检查WSL是否自带python环境：

python3 --version

如果输出版本号，说明WSL中已经预置了Python环境，但一般不会安装pip、uv等Python常见的包管理器。

这里有两个选择分支：

① 用户可以选择先安装docker，再从docker镜像一键拉取Hermes安装；

② 用户也可以选择继续安装pip和uv，随后再安装Hermes。

这里我选择Python路线（实测比Docker更复杂）：

# 安装pip sudo apt update # 安装pip后发现Ubuntu会禁止pip，需要更换为安装pipx sudo apt install -y python3-pip --fix-missing

3. 安装uv包管理器

① Ubuntu 为了防止用户通过pip随意覆盖系统自带的 Python 包（如apt安装的包），从而破坏系统稳定性，默认禁止了直接使用pip install。

因此，需要先安装pipx，再通过pipx安装uv：

# 1. 安装 pipx sudo apt install -y pipx # 2. 确保 pipx 的路径在环境变量中（重要！） pipx ensurepath # 执行后，请关闭当前 WSL 终端，重新打开一个新的WSL终端。 # 3. 在新的终端中，使用 pipx 安装 uv pipx install uv

② 将uv添加到PATH中：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

③ 刷新终端配置：

source ~/.bashrc

④ 检查uv是否安装成功：

# 二选一 uv --version which uv

4. 如果直接执行Hermes官方安装命令，会遇到连接被中断、镜像响应慢导致安装失败的问题（WSL+国内网络独有情况），此时需要配置网络代理，将WSL的网络代理至Windows的网关

① 在WSL中执行命令，找到WSL的网关ip，记下这个ip地址（假设为172.3.2.1）：

ip route | grep default

② 确认Windows网络代理监听的端口号，以v2***N为例，点击设置-参数设置-基础设置，可以看到“本地混合监听端口”号（假设为10809）；

③ 由于v2***N默认配置只监听本地(127.0.0.1)，需要修改为监听所有局域网的连接，即允许来自WSL的连接。操作方法：打开“允许来自局域网的连接”选项，以修改v2***N的监听地址：

④ 返回WSL，执行命令，以测试Windows代理端口是否可达：

# 替换为前几步确认的网关和端口 curl -v --connect-timeout 5 <http://172.3.2.1:10809>

5. 执行语句一键安装Hermes：

curl -fsSL <https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh> | bash

二、Hermes配置

1. 选择quick setup

2. 配置语言模型，我选择的是DeepSeek：

3. 在Base URL这一步不要输入，直接回车

4. IM工具选择的是飞书，但是选择后没有立刻要求绑定APP ID和APP Secret，后面需手动配置：

5. 启动成功！

配置新模型并切换至新模型

WSL中输入：

hermes model

选择模型并配置其他模型

配置完成后，启动Hermes，在Hermes中切换至新模型：/model

我这里是选择了配置自定义model，大家可以配置到其他商业模型

祝体验愉快！