Windows本地运行Hermes Agent需通过PowerShell一键部署（快速体验，无需WSL2）或WSL2原生部署（推荐长期使用，支持全部功能），二者均30分钟内可完成。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在Windows系统上本地运行Hermes Agent，但发现官方不提供原生支持，则必须借助兼容Linux环境的运行层。以下是两种经实测可在30分钟内完成部署的可靠方法：
一、PowerShell一键部署（适合快速体验）
该方式无需安装WSL2或任何Linux子系统，直接通过Windows原生命令行调用官方PowerShell安装脚本，自动检测并安装Python、Node.js、Git、ripgrep等全部依赖，全程图形界面无感知，适用于仅需基础对话功能的用户。
1、按Win + X键，选择“终端（管理员）”或“Windows PowerShell（管理员）”。
2、粘贴并执行以下命令：irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex。
3、等待脚本自动下载、解压、配置环境，进度条走完后将自动进入hermes setup向导。
4、在向导中输入1选择Quick setup，再根据提示输入模型供应商编号（如Z.AI为15、Kimi为8）、粘贴API Key（输入时不可见属正常）、填写Base URL及模型名称。
5、当看到绿色文字显示Hermes Agent is ready! You can now run 'hermes' to start chatting.即表示部署成功。
二、WSL2原生部署（推荐长期使用）
该方式在Windows中构建完整Ubuntu Linux运行环境，可启用Hermes Agent全部功能（包括Gateway网关、本地模型加载、systemd服务管理等），规避PowerShell下缺失lark-oapi、ffmpeg路径异常、uv虚拟环境隔离失败等已知缺陷，是官方唯一明确支持的Windows部署路径。
1、以管理员身份打开PowerShell，依次执行：dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart 和 dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart。
2、重启电脑。
3、重启后再次打开PowerShell（普通用户权限），执行：wsl --set-default-version 2。
4、执行：wsl --install -d Ubuntu-22.04，等待自动下载安装完成。
5、启动Ubuntu应用，设置Linux用户名（英文小写，无空格）和密码（务必牢记）。
6、在Ubuntu终端中执行国内镜像加速命令：sudo sed -i 's/archive.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list && sudo apt update && sudo apt upgrade -y。
7、运行Hermes安装脚本：curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash。
8、执行source ~/.bashrc刷新环境变量，随后验证：hermes version与hermes doctor均返回✅结果即为成功。
