安装指南

把 Hermes 跑起来

在 Linux、macOS 或 WSL2 上安装 Hermes Agent v0.8.0 大概 60 秒搞定。一条 curl 命令,安装脚本会替你处理 uv、Python 3.11、Node.js、ripgrep 和 ffmpeg。

checklist 系统要求

javascript Node.js

前置只需要 git——Python 3.11、Node.js v22、uv、ripgrep 和 ffmpeg 都由脚本负责装好

computer OS

Linux、macOS、Windows 上的 WSL2,或者通过 Termux 跑在 Android 上。原生 Windows 不支持。

memory RAM

内存至少 2 GB;跑本地模型的话要更多

hard_drive Disk

约 1 GB 磁盘空间——agent、它的 venv、Node 模块和内置 skill

extension Optional

可选:Docker、SSH、Daytona、Singularity 或 Modal,用来在沙盒里执行命令

wifi Network

调用托管模型 API 需要联网。用 OpenAI 兼容 endpoint 跑本地模型可以离线。

官方文档里的那条一行命令。Linux、macOS 或 WSL2 的大多数人用这个就行。 安装文档 arrow_forward

WSL2 (Windows)

原生 Windows 不支持。先跑 'wsl --install',然后在 WSL2 shell 里执行。

PS> curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

macOS / Linux / WSL2

前置只需要 git——uv、Python 3.11、Node.js v22、ripgrep 和 ffmpeg 都由安装脚本负责装好。

$ curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

verified 验证安装

跑一下官方文档里列的几条验证命令。

1
$ hermes version

输出已安装的版本(应该是 0.8.0 或更新)。

2
$ hermes doctor

跑一次诊断——Python、uv、依赖、配置文件和网络连接。

3
$ hermes status

打印当前配置:model provider、已启用的工具和已连接的 gateway。

settings 初始配置

装好之后重新加载 shell,再跑文档里的三条配置命令。

1

选一个 model provider

跑 'hermes model' 选一个 provider。README 里列了 Nous Portal、OpenRouter、z.ai/GLM、Kimi/Moonshot、MiniMax、OpenAI 和自定义 endpoint。Anthropic 和 Mistral 也作为依赖打包进来了。

2

启用你要用的工具

跑 'hermes tools' 来配置 47 个内置工具里哪些要启用。之后随时可以增删。

3

跑完整的配置向导

跑 'hermes setup' 过一遍完整向导,包括 API key 以及各 chat gateway 的接入(Telegram、Discord、Slack、WhatsApp、Signal、邮件)。

4

发一条测试消息

试试 'hermes chat -q "Hello! What tools do you have available?"' ——直接出自官方快速入门。

.env — 配置全部放在 ~/.hermes/ 下——主设置在 config.yaml,API key 在 .env,另外有 sessions、logs、memories、skills 和 cron jobs 的子目录。完整的环境变量参考看 hermes-agent.nousresearch.com/docs/reference/environment-variables。

cloud VPS / 服务器部署

Hermes 可以跑在任何 2 GB 内存、约 1 GB 磁盘的 Linux VPS 上。同样的安装命令在 SSH 下直接执行。

1

SSH 登录服务器

Ubuntu、Debian、CentOS、Arch 等常见发行版均可。

$ ssh user@your-server-ip
2

运行安装脚本

脚本会自动识别发行版、通过 uv 安装 Python 3.11 并配好所有依赖。

$ curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
3

启用沙箱后端

在共享基础设施上，建议配置沙箱后端（Docker、SSH、Daytona、Singularity 或 Modal），让 Hermes 的 shell 命令在隔离环境中执行。具体设置见 README。

4

设置 API key 并启动

选择模型提供商后启动 Hermes。进程运行在前台，建议用 tmux 或 screen 保持会话。

$ hermes model && hermes

Tip — 如果需要常驻守护进程，建议在 tmux/screen 中运行 Hermes，或编写 systemd unit 文件。官方文档中有 daemon 设置示例。

system_update_alt 升级 Hermes

README 里有个内置 updater:'hermes update'。目前没有发到 PyPI,也没有官方 Docker 镜像,所以其他升级路径都走 git。 升级指南 arrow_forward

npm
$ hermes update
pnpm
$ cd ~/.hermes/hermes-agent && git pull && uv pip install -e ".[all]"
Git
$ curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Docker
$ # 还没有发布官方 Docker 镜像

每个版本有什么新内容,去 github.com/NousResearch/hermes-agent/releases 看。

delete_forever 卸载 Hermes

Hermes 装在 ~/.hermes/hermes-agent/,并把 binary symlink 到 ~/.local/bin/hermes。两条命令就能全部清掉。 卸载说明 arrow_forward

npm
$ rm ~/.local/bin/hermes
pnpm
$ rm -rf ~/.hermes/hermes-agent
Git (Source)
$ rm -rf ~/.hermes/hermes-agent
Docker
$ # 没有官方 Docker 镜像可卸

清除用户数据(可选)

这一步会清掉你的 session、memory、skill、cron 任务和 API key。需要保留的先备份。

macOS/Linux $ rm -rf ~/.hermes
Windows PS> # 在 WSL shell 里跑——原生 Windows 不支持

build 故障排查

内容来自安装文档的故障排查表以及常见的安装脚本失败场景。 更多排错技巧 arrow_forward

需要帮助?

加入 Nous Research Discord,可以获取安装支持和社区排错。

forum 加入 Discord menu_book 官方安装文档
hub 集成 • article 博客 • apps 生态
❯

别掉队

Hermes Agent 的版本更新、新 skill、新集成——社区第一手消息。不发垃圾邮件,随时可以退订。