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

Windows本地部署Hermes Agent实录!WSL+Python部署路线详细步骤1 截至目前 Hermes 官方明确说明 Native Windows is not supported 因此 Win 系统使用 Hermes 必须安装 WSL 和 Linux 发行版 wsl install d Ubuntu 2 Hermes 是 Python 项目 后续需要用到 python 包管理器 uv

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



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 
  
    
     
    

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

 curl -fsSL 
  
    
    
      | bash 
    

1. 选择quick setup

2. 配置语言模型,我选择的是DeepSeek:

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

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

5. 启动成功!

WSL中输入:

 hermes model 

选择模型并配置其他模型

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

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

祝体验愉快!

小讯
上一篇 2026-04-27 11:01
下一篇 2026-04-27 10:59

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/280109.html