Hermes 安装

本页目标

学完这一页，你能够安装 Hermes Agent、选择模型提供商，并用 hermes doctor 检查是否存在阻断问题。

开始前

官方 Tier 1 包括 macOS Apple Silicon、Windows 10/11、Linux/WSL2 和 Docker；Android/Termux 为 Tier 2，Nix 是 best-effort。非 Windows 安装至少需要 Git，Linux 还需 curl 与 xz-utils。模型上下文窗口需至少 64K。

验证说明

验证说明： 命令、平台矩阵和账号条件已按 Nous Research 官方页面核对；本次未下载安装器或依赖，未进行 Nous Portal OAuth、其他 API key、模型请求、TUI/Gateway 启动，也未实际运行 doctor。不要把下面的检查标准当作本机结果。

跟着做

Linux、macOS 或 WSL2 的 Bash：

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

如果使用 zsh，把第二行改为 source ~/.zshrc。Windows 原生 PowerShell：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Windows 安装后关闭并重开 PowerShell。安装器通常会进入 hermes setup；如果跳过或需要更换提供商，在 Bash 或 PowerShell 中运行：

hermes model
hermes doctor

若已有 Nous Portal 订阅，可用 hermes setup --portal 通过 OAuth 配置模型与 Tool Gateway；这不是无需账号或订阅的免费模型承诺。

结果检查

hermes doctor 应能识别安装方式、环境和缺失项，并且没有阻止基础聊天的错误。原生 Windows 支持 CLI 和 TUI，但 Web Dashboard 的嵌入式终端面板需要 WSL2。

常见问题

安装后提示 hermes: command not found 时，先重开终端或刷新 shell，再检查 PATH；不要通过把密钥直接写进命令历史来绕过配置向导。

练习

本页小结

Hermes 安装包括运行官方安装器、完成模型配置和执行 doctor。先让基础环境可用，再添加消息渠道、Cron 或更多工具。