windows部署hermes agent需满足wsl2前提，推荐在wsl2 ubuntu中运行官方bash脚本；若失败，可选powershell安装、离线分步安装、强制指定python3.12/node.js20版本，或执行/model指令修复模型加载问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在 Windows 系统上部署 Hermes Agent，但发现直接运行脚本失败、依赖缺失或环境报错，则很可能是由于未满足 WSL2 前置条件或脚本执行路径错误。以下是针对 Windows 平台的多种一键安装方式及其对应避坑方案：
一、PowerShell 原生命令安装（推荐用于原生 Windows 环境）
该方式通过 Windows PowerShell 执行官方 PowerShell 安装脚本，适用于已启用 WSL2 但希望快速验证或轻量部署的用户。脚本会自动检测并安装 Python、Node.js、Git、ripgrep 等全部依赖。
1、以管理员身份打开 PowerShell。
2、执行以下命令（确保网络可访问 GitHub raw 内容）：
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
3、等待终端输出“Installation completed”及欢迎界面，表示主体安装完成。
4、若提示“Execution Policy”被阻止，请先运行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
二、WSL2 Ubuntu 终端中运行 Bash 安装脚本（官方唯一受支持方式）
根据 Hermes Agent 中文社区文档明确声明：“For Windows users, WSL2 is the only supported installation method.” 此方式在 Ubuntu 子系统内执行 Linux 原生脚本，规避 Windows 原生命令行兼容性问题，稳定性最高。
1、确认已启用 WSL2 并安装 Ubuntu 22.04 LTS（可通过 wsl -l -v 验证版本为 2）。
2、启动 Ubuntu 终端，运行系统更新：
sudo apt update && sudo apt upgrade -y
3、执行官方 Bash 安装脚本：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
4、若提示 “Unable to locate package ripgrep” 或 “ffmpeg not found”，需手动补装：
sudo apt install -y ripgrep ffmpeg
三、离线/受限网络环境下的分步安装替代方案
当无法直连 GitHub（如企业防火墙、国内无代理环境）时，自动脚本将中断。此时应跳过一键流程，改用本地下载+分步执行方式，确保每一步可控可验。
1、在可联网设备上分别下载以下文件并传入目标机：
install.sh、requirements.txt、pyproject.toml
2、在 WSL2 Ubuntu 中创建安装目录：
mkdir ~/hermes-install && cd ~/hermes-install
3、上传后赋予脚本执行权限：
chmod +x install.sh
4、使用清华镜像源加速 pip 安装：
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
5、手动运行核心步骤：
./install.sh --no-deps
pip install -r requirements.txt
四、关键依赖强制指定版本的修复操作
部分 Windows 用户在 WSL2 中遭遇 Python 或 Node.js 版本不匹配报错，例如 “Python 3.11+ required, but found 3.9.7”，说明系统默认 Python 不符合 Hermes Agent 运行要求，需主动覆盖。
1、安装 Python 3.12：
sudo apt install -y python3.12 python3.12-venv
2、设置默认 Python 版本：
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.12 1
3、安装 Node.js 20（通过 nvm）：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 20 && nvm use 20
4、验证版本：
python3.12 --version && node --version
五、安装后模型未加载的即时修复指令
即使脚本执行成功，部分用户仍会在启动后遇到模型状态栏显示为空或报错“model not found”，此问题源于 Windows 环境变量在 WSL2 启动初期未被完整继承，导致配置未生效。
1、进入 Hermes Agent 运行终端（非安装终端）。
2、输入内置指令：
/model
3、按提示输入模型名称（如 minimax 或 kimi）。
4、终端回显已配置模型名称即表示挂载成功，无需重启服务。
