Windows本地部署Hermes Agent实录！WSL+Python部署路线详细步骤
一、Hermes安装
1. 截至目前，Hermes官方明确说明”Native Windows is not supported“，因此Win系统使用Hermes必须安装WSL和Linux发行版：
wsl --install -d Ubuntu2. 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-missing3. 安装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 uv4. 如果直接执行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，大家可以配置到其他商业模型
祝体验愉快！