一、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.1ip 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:108095. 执行语句一键安装Hermescurl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash二、Hermes配置1. 选择quick setup2. 配置语言模型我选择的是DeepSeek3. 在Base URL这一步不要输入直接回车4. IM工具选择的是飞书但是选择后没有立刻要求绑定APP ID和APP Secret后面需手动配置5. 启动成功配置新模型并切换至新模型WSL中输入hermes model选择模型并配置其他模型配置完成后启动Hermes在Hermes中切换至新模型/model我这里是选择了配置自定义model大家可以配置到其他商业模型祝体验愉快
Windows本地部署Hermes Agent实录！WSL+Python部署路线详细步骤
发布时间：2026/7/14 12:33:38
一、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.1ip 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:108095. 执行语句一键安装Hermescurl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash二、Hermes配置1. 选择quick setup2. 配置语言模型我选择的是DeepSeek3. 在Base URL这一步不要输入直接回车4. IM工具选择的是飞书但是选择后没有立刻要求绑定APP ID和APP Secret后面需手动配置5. 启动成功配置新模型并切换至新模型WSL中输入hermes model选择模型并配置其他模型配置完成后启动Hermes在Hermes中切换至新模型/model我这里是选择了配置自定义model大家可以配置到其他商业模型祝体验愉快
![终极SMAPI模组加载器教程：轻松为星露谷物语添加无限可能 [特殊字符]](http://pic.xiahunao.cn/yaotu/终极SMAPI模组加载器教程：轻松为星露谷物语添加无限可能 [特殊字符])
)
