Windows 安装
重点只有一句话：Windows 和类 Linux / macOS 的安装命令不一样。
先决定走哪条路径
| 路径 | 适合谁 | 推荐程度 | 你要运行的命令 |
|---|---|---|---|
| WSL2 + Ubuntu | 想要最稳的日常使用体验，希望尽量贴近官方文档、终端工具和自动化工作流 | 强烈推荐 | 在 WSL2 里运行 install.sh |
| 原生 PowerShell | 想先在 Windows 本机快速跑起来，不想先配置 WSL2 | 可用，但更容易遇到兼容性问题 | 在 PowerShell 里运行 install.ps1 |
推荐结论
- 长期使用 / 工具链完整 / 网关与自动化更省心 ：优先选 WSL2 。
- 只是想先在 Windows 本机跑通 CLI ：可以直接用 PowerShell 。
中国大陆网络环境提示
如果你在中国大陆安装 Hermes，可能会遇到 raw.githubusercontent.com、PyPI、Node.js 下载或 npm registry 较慢的问题。站内不直接展开写代理/镜像配置步骤，建议直接参考这些外链：
- WSL 安装（中文帖子） ：Windows 10/11 安装 WSL2 指南
- WSL 终端代理 / 网络互通（官方） ：Microsoft Learn - Accessing network applications with WSL
- GitHub Raw 下载加速 ：清华 TUNA - GitHub Raw 镜像帮助
- Python / uv / pip 镜像 ：清华 TUNA - PyPI 镜像帮助
- Node.js 下载镜像 ：清华 TUNA - NodeJS Release 镜像帮助
- npm / pnpm registry ：npm config 文档 / npmmirror
方案一：WSL2（推荐）
第一步：在管理员 PowerShell 中安装 WSL2
如果你还没装过 WSL，建议先看这篇中文帖子：
然后再执行：
wsl --install -d Ubuntu
执行后按提示重启电脑。重启完成后，打开 Ubuntu ，设置 Linux 用户名和密码。
第二步：在 WSL2 终端里运行 Linux 安装命令
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
安装完成后，重新加载 shell：
source ~/.bashrc # 或：source ~/.zshrc
hermes
第三步：继续配置模型
hermes model
hermes setup
如果你只是需要一个最稳的 Windows 版本 Hermes，做到这里就够了。后续文档默认也更偏向这条路径。
如果你的模型跑在 Windows 主机上
例如 Ollama、LM Studio 跑在 Windows 本机，而 Hermes 跑在 WSL2 中，这时 localhost 不一定直接可用。请继续看 提供商文档里的 WSL2 网络配置。
方案二：原生 PowerShell（可用，但更容易踩坑）
一键安装
在 PowerShell 中运行：
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
这个安装器会自动尝试处理：
- uv
- Python 3.11
- Node.js
- Git
- ripgrep / FFmpeg
- Hermes 本体与虚拟环境
安装完成后，关闭并重新打开 PowerShell ，再运行：
hermes
hermes model
原生 Windows 安装后文件大致在哪里
默认安装目录通常在：
%LOCALAPPDATA%\hermes
例如：
- Hermes 主目录：
%LOCALAPPDATA%\hermes - 仓库目录：
%LOCALAPPDATA%\hermes\hermes-agent - 虚拟环境：
%LOCALAPPDATA%\hermes\hermes-agent\venv
如果 hermes 命令暂时不可用，最常见的解决方法就是：关掉当前 PowerShell 窗口，再开一个新的。
阅读全文
