等等党的胜利!如果你还没开始养“龙虾“,那么恭喜你现在不要再管“龙虾“了,因为你的“马“来了
Hermes,这里不是指的法国爱马仕,而是 AI Agent 中的又一批黑马
废话不讲,干货来了!
一、条件:
我这里采用的是云服务器,你也可以使用本地安装,虚拟机安装,或者 docker 安装
云服务器配置:腾讯云服务器 2 c 2 g,Ubuntu 22.04 LTS (AI 社区支持比较好)
二、步骤:
(一) 前置条件
只要有 git 就可以,如果你没有,看这里:
以 Ubuntu 系统为例
# 更新软件包列表
sudo apt update
# 安装 Git
sudo apt install git -y
# 验证安装
git --version
# 输出示例:`git version 2.41.0`,则为成功
(二)一键安装
在云服务器的终端里面运行一下命令:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
这里推荐一个 SSH 工具:Termius,链接:termius.com/
(三)手动安装:
如果你跟我一样,使用的是国内的云服务器,那很有可能在使用一键安装命令时,卡死在最后一步,即克隆代码时总是被阻断。
这是因为,国内的云服务器在连接 GitHub 时,经常会遇到严重的限速或间歇性断流。
那么请不用着急,因为我们完全可以采取下面的方式来继续完成 Hermes 的安装:
graph LR
A[本地下载] --> B[上传服务器]
B --> C[手动配置]
注意:如果你已经运行过了上面的一键安装命令之后。该命令已经自动地为你安装了 uv,Python, Node.js,ripgrep,ffmpeg;如果没有运行一键安装命令,请先去安装好。
这里默认你运行过一键安装命令,但卡在了云服务器连接 GitHub,所以我们要做的工作就是把 github 上的代码克隆下来,上传到服务器上,配置好运行环境。
(1)清理刚才克隆了一半的残余文件
如果文件夹已经存在,脚本可能会报错,先执行以下命令清理:
rm -rf /home/ubuntu/.hermes/hermes-agent
(2)在你的个人电脑上下载代码
-
在你的电脑浏览器中打开仓库地址:github.com/NousResearc…
-
点击页面右侧绿色的
<> Code按钮。 -
在弹出的菜单中选择
Download ZIP。 -
等待下载完成,你会得到一个名为
hermes-agent-main.zip的文件。
(3)将 ZIP 文件上传到服务器
使用 Termius 的 SFTP 上传文件到服务器(使用其他 SSH工具也可以)。直接将你下载到电脑上的 hermes-agent-main.zip 上传到云服务器默认的 /home/ubuntu/ 目录下。
(4)在服务器上解压并放置代码
成功登录到你的腾讯云服务器后,依次复制执行以下命令:
- 安装解压工具(以防系统没自带):
sudo apt update && sudo apt install unzip -y
- 创建官方脚本默认的隐藏目录:
mkdir -p /home/ubuntu/.hermes
- 解压文件到该目录:
unzip /home/ubuntu/hermes-agent-main.zip -d /home/ubuntu/.hermes/
- 重命名文件夹(因为 GitHub 下载的压缩包解压后会多一个
-main后缀,我们需要把它去掉,保持和官方路径完全一致):
mv /home/ubuntu/.hermes/hermes-agent-main /home/ubuntu/.hermes/hermes-agent
- 清理安装包(节约空间):
rm /home/ubuntu/hermes-agent-main.zip
(5)手动初始化项目(替代一键安装脚本的最后一步)
此时代码已经就位,我们只需要使用你服务器上已经安装好的 uv 包管理器来同步依赖即可。
- 进入项目目录:
cd /home/ubuntu/.hermes/hermes-agent
- 同步并安装所有依赖:
uv sync
🎉 完成! 等待 uv sync 执行完毕后,Hermes Agent 的环境就彻底搭建好了。
(6)让我们把 Hermes 跑起来
- 把启动命令写进你的终端配置文件中
# 打开配置文件
nano ~/.bashrc
- 在. bashrc 文件最后一行粘贴如下命令
hermes() {
(cd ~/.hermes/hermes-agent && uv run hermes "$@")
}
- 重新加载配置文件
source ~/.bashrc
- 现在,在任何目录下直接输入 hermes 调用 Hermes
- 在 hermes 的输入框里输入
/quit退出 Hermes:
(7)配置 LLM Provider API 密钥
这里以OpenRouter 为例,为什么用 OpenRouter,一有免费模型,二可以随时切换不同厂商的模型。
申请 API key
-
进入网址:openrouter.ai/
-
点击 Get API Key
- 点击 Create
配置方式一:
- 切换到 Hermes 的项目目录下:
cd ~/.hermes/
- 编辑配置文件 :
nano .env
- 在. env 文件中配置 OpenRouter 平台的API key:
OPENROUTER_API_KEY=sk-or-v1-.....
配置方式二:
- 运行以下命令:
hermes setup
-
选择 Model & Provider:
-
配置你想用的 API key:
调用 Hermes,开启你和“小马”的第一句对话:
三、下一步
Hermes 支持接入 Telegram、Discord、Slack、飞书、企业微信、Signal、WhatsApp 等 10+ 消息平台,挑一个你喜欢的,去玩耍吧。
Hermes 最强大的优势用一句话概括——用的越多越聪明。用户设置规则、它学习规则、然后逐渐改进,让用户越用越顺手。
如果你感兴趣,别再等待,先装上,用起来,感受一下会进化的 AI。