Hermes Agent

Hermes Agent 是 Nous Research 推出的开源 self-improving AI 智能体，它会自主学习、持续进化，并拥有持久记忆系统。

​

快速开始

​

Step 1: 安装 Hermes Agent

Hermes Agent 支持 Linux、macOS、Windows 原生与 Android（Termux）。

​

macOS / Linux / WSL2

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

安装完成后重载 shell 配置：

source ~/.zshrc   # 或 source ~/.bashrc

​

Windows（原生，PowerShell）

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

无需 WSL2。

​

Android（Termux）

Hermes 为 Termux 提供了 APT 源，按官方指南安装： Termux 安装指南

桌面端用户也可以直接从官网下载 Hermes Desktop 安装器。

​

Step 2: 接入 AIHubMix（官方插件）

AIHubMix 的 model provider 插件已收录进 Hermes 官方插件目录（curated catalog），一条命令安装：

hermes plugins install aihubmix   # 从官方目录安装插件
hermes plugins enable aihubmix    # 目录安装的插件默认不启用，需手动启用

老版本 Hermes（2026-09-02 之前的构建）只从 ~/.hermes/plugins/model-providers/ 发现 model provider，而目录安装把插件放在上一层 ~/.hermes/plugins/aihubmix/，因此不会注册。先升级 Hermes；无法升级时手动把目录移过去并重启 Gateway：

mkdir -p ~/.hermes/plugins/model-providers
mv ~/.hermes/plugins/aihubmix ~/.hermes/plugins/model-providers/aihubmix
hermes gateway restart

​

配置 API Key

把 Key 写进 $HOME/.hermes/.env（Hermes 的凭据文件，所有密钥都放这里，不要写进 config.yaml）：

echo 'AIHUBMIX_API_KEY=sk-***' >> ~/.hermes/.env

在 API Key 页面生成。写入后重启 Gateway 或新开终端使其加载。hermes doctor 会用该变量探测 AIHubMix 模型目录接口的连通性。

仅在终端 export AIHUBMIX_API_KEY 对插件供应商不一定生效（运行中的 Gateway 读的是 .env）。用 --provider custom 直调自定义端点时，进程内环境变量则是生效的。

​

使用

hermes --provider aihubmix --model gpt-5.5

也可以启动 Hermes 后用 /model 交互切换，在供应商列表中选择 AIHubMix。插件从 AIHubMix 的模型目录接口拉取模型列表，只列出支持工具调用的条目；目录接口不可用时回退通用的 /v1/models。把 AIHUBMIX_BASE_URL 写进 ~/.hermes/.env 可将插件指向代理或自建中转地址（此时改用 {base_url}/models 获取列表）。

源码与完整说明：AIhubmix/hermes-provider-aihubmix

​

Step 3: 手动配置 Custom endpoint（可选）

不想装插件时，用 hermes model 向导手动接入：选择 Custom endpoint，API base URL 填 https://aihubmix.com/v1，API Key 填 AIHubMix 的 Key，模型 ID 填平台上的模型编号（如 gpt-5.5、glm-5.3、claude-sonnet-5-5）。

也可以用命令一次性验证（不写配置文件）：

AIHUBMIX_API_KEY=sk-*** hermes chat --provider custom --base-url https://aihubmix.com/v1 --model gpt-5.5 -q "hi"

hermes setup 当前的三种模式是 Quick Setup（Nous Portal）、Full Setup 和 Blank Slate；供应商与模型的配置统一在 hermes model 里进行。

​

Step 4: 运行测试

1. 终端输入 hermes 进入交互对话。
2. 发送一条消息（如介绍 AIHubMix），模型正常回复即接入成功；如需排查，运行 hermes doctor。

​

用 Hermes Desktop 接入

使用 Hermes Desktop（图形界面）时无需命令行：

1. 打开 Settings → Providers → Custom Endpoints，点 + Add Endpoint（或 New endpoint）：

2. Name 填 aihubmix，Endpoint URL 填 https://aihubmix.com/v1，API Mode 保持 Auto-detect，Default Model 填平台模型编号，API Key 填 AIHubMix 的 Key；点 Test 检查连通（Discover models 可拉取模型列表），然后 Save。
3. 回到主界面点模型选择器，在 AIHUBMIX 分组中选一个模型：

4. 直接发送消息验证：

​

常用指令

hermes                # 开始对话
hermes model          # 选择模型供应商
hermes doctor         # 诊断凭据与供应商连通性
hermes tools          # 配置要启动的工具
hermes gateway setup  # 设置消息平台
hermes update         # 升级 Hermes

​

常见问题

​

用 owner/repo 简写装的插件没生效？

hermes plugins install AIhubmix/hermes-provider-aihubmix 与按目录名安装走的是两条路：在老构建上前者把仓库克隆到 ~/.hermes/plugins/<仓库名>/，该位置不在 model provider 的发现路径内，插件不会注册。请改用目录名安装（hermes plugins install aihubmix，本插件已收录官方目录），或按 Step 2 中的 Note 手动移动目录。

​

插件方式与 Custom endpoint 有什么区别？

Custom endpoint 需要手动填写 base URL 和模型编号。插件把 AIHubMix 注册成具名供应商 aihubmix，支持 --provider aihubmix 直接调用，模型列表由 AIHubMix 模型目录接口自动填充，并过滤为支持工具调用的模型。

​

/model 里模型列表为空或偏少怎么办？

先确认 AIHUBMIX_API_KEY 已写入 ~/.hermes/.env 且有效，可用 hermes doctor 检查。列表只包含标注了工具调用能力（tools 或 function_calling）的模型，因此会少于全量模型数。若设置了 AIHUBMIX_BASE_URL 且与默认地址不同，插件改用 {base_url}/models 获取列表。

​

提示 No usable credentials found？

插件供应商从 ~/.hermes/.env 读凭据：确认该文件里已有 AIHUBMIX_API_KEY，并重启 Gateway 或新开终端；另外确认插件处于 enabled 状态（hermes plugins list）。若用 --provider custom 方式，则进程内环境变量即可。

---

更新时间：2026-10-28