Ubuntu安装Hermes Agent教程

# Hermes Agent 介绍
Hermes Agent 是 Nous Research 推出的开源自托管 AI 智能体框架，具备持久记忆、自主沉淀技能与自我进化能力，可本地部署执行自动化任务，运行越久能力越强。

# 准备Ubuntu操作系统
参考：
A33-Vmware安装Ubuntu24
https://wiki.bafangwy.com/doc/858/

# 安装Hermes
虚拟机全程用root用户避免权限问题

更新软件源（这个可能要花比较长的时间）
`apt update && sudo apt upgrade -y`

安装基础依赖（200多M）
`apt install git curl python3 python3-pip -y`

安装npm
`apt install -y nodejs npm`

## 安装方式1：一键安装
需要解决github网络不稳定的问题。

安装Hermes 核心程序
`curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash`

要是无法连接github的域名，也可以直接把这个脚本下载、解压、传到Linux：

[【附件】install.zip](/media/attachment/2026/04/install.zip)

然后
`chmod +x install.sh`

验证安装：
`hermes doctor`

## 安装方式2：手动安装
确认python版本：
`python3 --version`

查看路径：
`which python3`

记下这个路径，例如：
`/usr/bin/python3`

Hermes 官方手动安装流程里使用 uv 来创建虚拟环境和安装依赖。
```
curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc
uv --version
```

mkdir -p ~/apps
cd ~/apps
git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git

启用虚拟环境
```
cd ~/apps/hermes-agent
uv venv venv --python /usr/bin/python3
source venv/bin/activate
```

告诉 uv 把包装到当前项目的虚拟环境里
以开发模式安装 Hermes，并安装官方定义的全部常用扩展
```
export VIRTUAL_ENV="$(pwd)/venv"
uv pip install -e ".[all]"
```

npm要用于浏览器自动化和 WhatsApp bridge
`npm install`

创建 Hermes 配置目录
```
mkdir -p ~/.hermes/{cron,sessions,logs,memories,skills,pairing,hooks,image_cache,audio_cache,whatsapp/session}
cp cli-config.yaml.example ~/.hermes/config.yaml
touch ~/.hermes/.env
```

把 hermes 命令加入全局 PATH
```
mkdir -p ~/.local/bin
ln -sf "$HOME/apps/hermes-agent/venv/bin/hermes" ~/.local/bin/hermes
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
```

检查是否成功：
`which hermes`

# 获得MiniMax API Key
MiniMax API Key申请与调用
https://wiki.bafangwy.com/doc/912/

使用 hermes model 交互配置
`hermes model`