顶级AI顶级AI

安装 Hermes

Last updated on

把 Hermes 真正装到环境里,并确认 hermes 命令已经能正常运行。先完成安装和命令验证,下一页再继续配置。

这一页只解决安装本身

前一页你已经确认了平台支持、provider 和首次接入范围。

所以这一页不讲消息平台、不讲高级配置,也不讲长期运维,只专门解决:Hermes 怎么装,装完后怎么确认命令真的能用

安装前先确认你已经准备好了运行环境

这里默认你已经完成了前一页内容

如果你还没确认平台支持和 provider,先回去看 准备工作

开始前,先确认下面两件事:

  • 如果你是 Windows 用户,已经进入 WSL2 环境
  • 你已经准备好后面要使用的 provider 账号或 API Key

用官方安装脚本安装 Hermes

官方安装路径对新手其实已经做了很多自动处理

官方安装文档里说明,这条安装路径会自动处理一部分运行依赖。

对新手来说,你通常不需要先自己手动把 Python、Node.js、ripgrep、ffmpeg 这些一个个预装完,再回来装 Hermes。

这一条快速安装路径真正需要你先确认的基础前提,主要是 Git 已经可用。

1. 在终端里运行官方安装命令

官方 README 当前给出的快速安装方式是:

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

这条命令适用于 Hermes 当前主要支持的环境,比如 Linux、macOS、WSL2,以及 Android 上通过 Termux 使用。

2. 等安装完整跑完,不要中途关闭终端

安装过程中,终端会输出下载和安装信息。

这个阶段你先不要急着继续做别的事,先让安装完整结束。

什么状态说明安装大概率已经结束?

终端回到可以继续输入命令的状态,并且没有停在明显的报错上。

3. 按当前 shell 重新加载环境

官方 README 安装后给出的下一步是重新加载 shell,例如:

source ~/.bashrc

如果你用的是 zsh,对应一般是:

source ~/.zshrc

这一步的目的,是让当前终端立刻识别到刚装好的 hermes 命令。

安装完成后,先检查命令能不能被识别

1. 直接运行 Hermes

安装完成并重新加载 shell 后,直接运行:

hermes

如果 Hermes 能正常进入交互界面,说明安装链路大概率已经通了。

2. 如果你还不放心,再看几个基础命令

你也可以继续尝试这些命令来确认 CLI 已经存在:

hermes model
hermes setup
hermes doctor

只要这些命令已经不再是“找不到命令”,就说明安装本身基本没问题。

如果安装后命令还是不通,先怎么判断

最常见的问题,往往不是 Hermes 本身坏了

更多时候,是你当前环境不符合官方支持范围,或者安装后还没让当前 shell 重新加载命令。

1. 先确认你是不是在官方支持的平台里安装

如果你在原生 Windows 里直接装,问题就很可能出在这里。

Windows 用户优先回到 WSL2 里重新做安装动作。

2. 再确认你有没有重新加载 shell

很多时候安装脚本已经跑完了,但你当前终端还没刷新到新的命令环境。

优先重新执行:

source ~/.bashrc

或者对应你当前 shell 的加载命令。

3. 还是不行,就先停在安装阶段排查

如果 hermes 这个命令本身都还不能正常启动,就不要急着往下写配置和接 provider。

这时先回头排查平台、终端、安装脚本执行过程,通常更快定位问题。

这一步做完,什么状态算合格

满足下面这 3 条,就说明安装已经完成了

  • 你已经在官方支持的平台环境里执行了安装
  • 你已经让当前 shell 重新加载过环境
  • hermes 命令已经能正常进入交互界面,或者至少不再提示找不到命令

做到这里,安装这一步就完成了。

下一页继续看 配置 Hermes

On this page