乐于分享
好东西不私藏

Hermes Agent 手把手安装教程

Hermes Agent 手把手安装教程

去搜索"Hermes Agent 怎么安装",大概率会看到这种教程:

“克隆仓库,进入项目目录,配置虚拟环境,设置环境变量……”

看到第一行就关掉了对吗?

这篇就是专门写给看不懂那些教程的人的。没有"克隆仓库",没有"环境变量",只有一步一步告诉你点哪里、输什么、看到什么就代表成功了。你只需要会复制粘贴。

根据你的电脑是 Mac 还是 Windows,直接翻到对应的部分,按顺序来就行。


Mac 用户

第一步:打开终端

两个方法:

  • • 按 Command + 空格,搜索"终端",回车打开
  • • 或者打开"启动台",找到"其他"文件夹,里面有终端

打开后会出现一个窗口,里面有一行文字和光标等着你输入,这就对了。

第二步:粘贴安装命令,等它跑完

把下面这行完整复制,粘贴进去,按回车:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
安装命令运行中

它会自动下载并安装所有需要的东西,不用你再操心别的。安装时间看网速,一般几分钟。看到光标重新出现、停下来不动了,就说明装完了。

第三步:让电脑记住刚装好的东西

输入下面这行,按回车:

source ~/.zshrc

这一步不做,后面会提示"找不到命令"。

确认安装成功

分别输入这两个命令:

hermes versionhermes doctor

hermes version 出现版本号,hermes doctor 显示全绿,就可以去配置 API Key 了。

version 和 doctor 成功界面

Windows 用户

Windows 有两种安装方式,推荐先试第一种。第一种搞定了就不用管第二种。

方式一:直接安装

这种方式最简单。目前还在完善中,少数机器上可能会碰到问题——装完验证失败的话,换方式二就行。

第一步:打开 PowerShell

按 Windows 键,输入 powershell,点击打开。

第二步:粘贴安装命令,等它跑完

iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)

等它跑完,输入 hermes version,出现版本号就成功了,可以直接跳到"填入 API Key"那一节。

如果这里报错,或者 hermes version 提示找不到命令,走方式二。


方式二:通过 WSL2 安装(更稳定)

WSL2 是 Windows 自带的一个功能,相当于在你电脑里开了一个独立的小系统,专门用来跑这类工具。装完就不用再管它了。

已经装好 WSL2 的,跳过下面这段,直接到"在 WSL2 里装 Hermes"。

装 WSL2

第一步,在开始菜单搜索 PowerShell,右键点击,选"以管理员身份运行"。

第二步,输入下面这行,回车:

wsl --install

第三步,等它装完,按提示重启电脑。

第四步,重启后会自动弹出一个黑色窗口,让你设置用户名和密码。随便起名字,密码也随便设,记住就行。输密码的时候屏幕上不会显示任何东西,这是正常的,输完直接按回车。

WSL2 就装好了。

在 WSL2 里装 Hermes

第一步,开始菜单搜索"Ubuntu",打开它(WSL2 装好后会自动安装 Ubuntu)。

第二步,复制下面这行,粘贴进去,回车:

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

等它跑完。

第三步,输入:

source ~/.bashrc

第四步,输入 hermes version 验证,出现版本号,再跑 hermes doctor 确认全绿,装好了。


填入 API Key,配好模型

输入:

hermes model

按提示选择模型提供商,填入 API Key。

注意:API Key 和模型提供商必须对上。 比如你用的是 OpenAI 的 Key,提供商就选 OpenAI;用的是 Anthropic 的 Key,就选 Anthropic。选错了会一直提示认证失败,但 Key 本身没问题,换回正确的提供商就好了。

model setup 成功界面

发一句话,确认完全跑通了

输入:

hermes chat -q "你好,Hermes。请用中文确认你已经正常工作。"

收到正常的 AI 回复,就说明全部搞定了。

首次回复成功界面

常见问题

看到"command not found"没有执行 source 那一步,或者执行了但没生效。重新输一遍对应的 source 命令,再试。

安装到一半卡住不动了基本是网络访问 GitHub 不稳定。检查网络,如果需要挂代理,挂上之后重新跑安装命令。

PowerShell 提示"无法加载文件,因为在此系统上禁止运行脚本"Windows 的安全策略在拦截。在 PowerShell 里输入:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

回车,输入 Y 确认,然后重新跑安装命令。


遇到这里没提到的报错,或者按步骤来还是装不上,可以把报错信息截图贴到评论区寻求帮助哦。