脚本之家 服务器常用软件
快捷导航
您的位置：主页 > AI > 其他 > Windows部署Hermes Agent

Windows本地部署Hermes Agent实录

  发布时间：2026-06-05 09:38:45   作者：憩鱼   我要评论
文章浏览阅读856次，点赞13次，收藏4次。Windows本地部署Hermes Agent最新实录，附WSL+Python部署路线详细步骤，Docker路线待尝试_wsl安装hermes

一、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的网关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，大家可以配置到其他商业模型

祝体验愉快！

到此这篇关于Windows本地部署Hermes Agent实录的文章就介绍到这了,更多相关Windows部署Hermes Agent内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！

相关文章

最新评论

关注微信公众号

扫一扫