Hermes 安装

动手之前先装好环境。本篇覆盖各平台的安装方式，并纠正一个常见误解，原生 Windows 现在已经受支持。

前置条件

• Git 可用（用于拉取技能与插件）。
• 4GB 以上内存，跑轻量模型时更顺。
• 网络畅通，首次安装需要从官方源下载。

Hermes 的安装脚本会自动帮你装好所需的 Python 运行环境与依赖，一般不必手动准备。

推荐方案：一键安装（Linux / macOS / WSL2）

在终端执行官方安装命令：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

脚本会下载并配置好一切，结束后你就可以在终端输入 hermes 启动。

国内用户：镜像加速（非官方，自行甄别）

官方源在部分地区访问较慢。社区维护了一个镜像源，可用它替代官方脚本：

curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

注意，这是非官方镜像，使用前请自行确认其可信度。如果介意，仍建议走官方源，或自行配置网络环境。

Windows 用户

早前的资料常说「原生 Windows 不支持，必须先装 WSL2」。这个说法已经过时。当前版本中，Hermes 的 CLI、网关、TUI 和工具在原生 Windows 上都能直接运行。

不过实践上仍有两点建议：

• 如果你用 Windows，装一个 WSL2（Ubuntu）再装 Hermes，体验最稳，也最容易对照官方文档排错。
• 原生 Windows 也可行，适合不想折腾 WSL 的用户。

总之，Windows 不再是障碍，只是推荐 WSL2 作为更顺手的选项。

验证安装

安装完成后，查看版本号确认成功：

hermes --version

能正常输出版本号，说明命令行入口已经就绪。

常见安装问题与避坑

• curl 不存在：Windows 上请先装 Git for Windows，它自带 curl 与 bash 环境。
• 网络超时：换网络环境，或尝试上一节的国内镜像。
• 权限不足：安装脚本会写用户目录，一般无需 root；若提示权限问题，检查对应目录是否可写。
• 装完命令找不到：重开终端，或执行 source ~/.bashrc（Linux/macOS）让 PATH 生效。

本篇小结

• 官方一键安装：curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash。
• 国内镜像 res1.hermesagent.org.cn 为非官方，按需选用。
• 原生 Windows 现已支持，WSL2 只是推荐而非必须。
• hermes --version 验证安装结果。

下一篇我们配置模型，发出第一条消息，把对话真正跑通。