资料核对日期:2026-11-16。未做本地安装实测。本文采用 Linux、macOS 和 WSL2 的 POSIX 源码脚本路线;原生 Windows 的依赖准备方式不同,请使用官方 Windows 安装入口,不套用本文的预装条件。安装脚本跟踪 main 分支,代表获取最新变更,不应视为稳定版本承诺;执行前可到 Hermes 官方文档再次核对当前支持情况。

准备安装环境

官方安装页“前置条件”将 POSIX 源码脚本的条件列为 Git、curl、tar 和 SHA-256 工具;源码构建还可能需要编译器及系统库。Hermes 的 Python 要求是 3.14(>=3.14,<3.15),工具版本由 pm/lock.json 决定,按官方受管理的安装流程准备运行时,不要用 pip install hermes-agent 替代。这里的预装工具条件仅针对 POSIX 源码脚本;Windows 源码安装由 PM 准备 Python、Node.js 等依赖,缺少 Git 时还会下载 Git for Windows,两者并不使用同一份预装清单。

还需要一个可用的模型服务。Hermes 要求模型至少具备 64,000 token 的上下文窗口,启动时会拒绝上下文不足的模型。本文优先采用 Nous Portal 配置路径;如果没有对应订阅,可改用 hermes model 选择其他 provider,并完成其要求的真实认证。示例密钥只能说明格式,不能直接作为配置值。

从官方入口安装

Linux、macOS 或 WSL2 打开终端,运行:

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

该方式会跟踪 main 分支。官方列出的默认位置是:源码位于 ~/.hermes/hermes-agent/,命令包装器位于 ~/.local/bin/hermes,数据目录为 ~/.hermes/。

原生 Windows 安装请转到官方安装页的 Windows 小节,本篇后续终端命令均针对 POSIX 路线。

配置模型并开始第一次对话

POSIX 环境安装后,先重新加载当前 shell:

source ~/.bashrc   # 或:source ~/.zshrc

如使用 Nous Portal,可运行:

hermes setup --portal

该命令会完成登录、将 Nous 设为 provider,并开启 Tool Gateway。没有 Portal 订阅时,改用交互式配置:

hermes model

按提示选择一个 provider 和满足上下文要求的模型,并完成 OAuth 或输入有效密钥。不要把文档中的 sk-or-...、your_key 等占位符当作真实凭据。

配置完成后启动经典 CLI:

hermes

看到欢迎横幅后,输入一个容易核对的任务,例如:

Summarize this repo in 5 bullets and tell me what the main entrypoint is.

预期结果是横幅显示所选模型或 provider,Hermes 无错误地给出回复,并能继续第二轮对话。第一次验收只需确认基础聊天正常,不必立即添加 gateway、skills、cron 或其他功能。

对话失败时怎样检查

如果终端提示 hermes: command not found,先重新加载 shell;仍无效时检查 PATH 是否包含安装脚本生成的命令入口。若 Hermes 能启动但回复为空、异常或提示认证问题,重新运行:

hermes model

确认 provider、模型及认证信息。需要进一步诊断时运行:

hermes doctor

该命令会指出缺失项及修复方向。修复后再次运行 hermes,以“横幅显示正确模型、收到无错误回复、能够继续多轮对话”作为本次安装验收标准。

官方参考资料

继续阅读