零基础Windows用户需先启用WSL2并安装Ubuntu 22.04，再执行一键安装脚本（国际/国内源），接着配置OpenAI兼容API（如yibuapi），最后运行hermes doctor与hermes chat验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在 Windows 系统上零基础完成 Hermes Agent 的本地部署，但面临环境配置复杂、依赖缺失或安装脚本执行失败等问题，则很可能是由于未正确启用子系统或未使用管理员权限运行安装程序。以下是针对 Windows 用户的一键式部署操作指南：
一、启用 WSL2 子系统并安装 Ubuntu
Windows 原生不支持 Hermes Agent 直接运行，必须通过 WSL2 构建兼容的 Linux 运行环境。该步骤为所有后续操作的基础，缺失将导致安装脚本无法执行。
1、以管理员身份打开 PowerShell。
2、依次执行以下两条命令：
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
3、重启电脑后，在普通 PowerShell 中运行：wsl --set-default-version 2。
4、前往 Microsoft Store 搜索并安装 Ubuntu 22.04 LTS，首次启动时设置全小写用户名与密码（密码输入时无显示属正常）。
二、执行一键安装脚本
安装脚本会自动检测并部署 Python 3.11、Node.js v22、Git、ripgrep 等全部必要组件，无需手动干预，适用于绝大多数网络环境。
1、在 Ubuntu 终端中，根据网络情况选择对应命令：
国际网络用户执行：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
国内用户执行：curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash
2、等待终端输出 [OK] 且无红色 Error 提示，即表示安装成功。
3、立即执行：source ~/.bashrc 刷新环境变量，否则 hermes 命令将不可识别。
三、PowerShell 原生安装（备选方案）
当 WSL2 方案因企业策略、磁盘空间不足或虚拟化被禁用而不可行时，可采用官方提供的 Windows 原生命令行安装方式。该方式绕过 Linux 子系统，直接在 PowerShell 中完成部署。
1、以管理员身份打开 PowerShell。
2、执行：irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
3、等待提示 Installation completed successfully，表明 Python、Node.js、Git 等已自动安装并注册全局 hermes 命令。
4、关闭并重新打开 PowerShell，输入 hermes --version 验证命令是否可用。
四、配置模型服务接入
Hermes Agent 本身不内置大模型，必须通过外部 API 接入才能响应对话。配置错误将直接导致空响应或启动失败，因此该步骤不可跳过。
1、在终端中输入：hermes setup 启动交互式配置向导。
2、使用方向键选择 Custom endpoint (OpenAI compatible)。
3、粘贴 Base URL：https://api.yibuapi.com/v1（一步 API 推荐地址）。
4、粘贴从 yibuapi.com 控制台获取的 sk- 开头的 API Key，系统将自动保存至 config.yaml。
五、验证运行状态
完成模型配置后，Hermes 将初始化本地数据目录 ~/.hermes/，包含 SQLite 数据库、技能文件夹与记忆文件夹。此步骤用于确认服务是否具备完整运行能力。
1、执行：hermes doctor 对环境进行全项检测。
2、若所有检查项均显示绿色 [✓] 或 OK，说明配置无误。
3、输入：hermes chat 进入交互界面，发送任意消息测试响应。
4、输入 /exit 可退出当前会话。
