安装指南

Hermes Agent 可运行于任何支持 Python 或容器的环境。根据目标环境选择合适的安装方式。

一键安装（推荐）

Linux / macOS / WSL2

curl -fsSLO https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh
less install.sh
bash install.sh

安装完成后重新加载 shell：

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

Windows

如果你会长期使用 Hermes 处理代码、终端命令和项目依赖，推荐先安装 WSL2，再在 WSL2 的 Ubuntu 终端里运行 Linux 安装命令。

使用 pipx 手动安装

pipx install hermes-agent

如果你没有安装 pipx，可以先运行：

python -m pip install --user pipx
python -m pipx ensurepath

随后重新打开终端，或重新加载 shell 配置。

Docker

docker run --rm -it \
  -v ~/.hermes:/root/.hermes \
  -e OPENAI_API_KEY=$OPENAI_API_KEY \
  nousresearch/hermes-agent:latest

终端后端

Hermes 支持 6 种执行后端，通过 hermes config 配置：

• local：本地直接运行。
• docker：沙箱化工具执行。
• ssh：委托到远程主机执行。
• daytona：临时开发环境。
• singularity：HPC 工作负载。
• modal：无服务器 GPU / 休眠。

常用切换命令：

hermes config set terminal.backend docker
hermes config set terminal.backend ssh

本地后端最直接；Docker 更适合隔离命令执行；SSH 适合把耗时任务放到远程服务器上跑。

配置模型

安装后运行：

hermes model

它会引导你选择 OAuth 登录、API Key 或自定义 OpenAI 兼容端点等接入方式。你也可以运行 hermes setup 一次性完成模型和工具配置。

验证

hermes --version
hermes doctor

hermes doctor 会运行诊断并打印缺失依赖或错误配置。

如果安装成功但命令找不到，通常是 shell 还没有加载新 PATH。尝试关闭并重新打开终端，或运行 source ~/.bashrc / source ~/.zshrc。