Hermes Agent 是 Nous Research 开源的自主 AI 智能体框架，您可以将其部署在本地服务器上，接入多种大模型，它能跨会话记忆、自动创建技能并持续自我进化，完成复杂的自动化任务。本文以 Hy3 preview 模型为例演示如何将模型接入到 Hermes Agent 中使用。
环境准备
支持的操作系统
Hermes Agent 支持以下操作系统：
macOS 12 及以上版本（Apple Silicon 与 Intel 芯片均支持）。
Linux（Ubuntu 20.04+、Debian 11+、CentOS 8+ 等主流发行版）。
Windows 10/11（建议通过 WSL 2 安装与运行）。
前置依赖
请在安装 Hermes Agent 之前，先在本机安装 Git。可执行以下命令验证是否已安装：
git --version
若提示命令未找到，请按所用系统选择安装方式：
macOS： 执行
xcode-select --install，或通过 Homebrew 安装：brew install gitLinux（Debian/Ubuntu）：
sudo apt update && sudo apt install -y gitLinux（CentOS/RHEL）：
sudo yum install -y gitWindows： 前往 Git 官网 下载安装包后安装，或在 WSL 中按对应 Linux 发行版的方式安装。
安装 Hermes Agent
请执行以下命令安装 Hermes Agent：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
安装完成后，您可以执行如下命令验证安装是否成功：
hermes doctor
获取 API Key
1. 进入 API Key 管理 页面，单击创建 API Key。操作详情请参见 创建 API Key。
注意：
在设置可访问范围时，如果选择“限定范围”，则需要确保勾选 Hy3 preview。
2. 创建完成后，请您务必复制并妥善保管 API Key，在后续配置到工具的流程中将会使用该信息。
配置 Hermes Agent
注意：
配置步骤可能随 Agent 版本有所调整，请以您使用的版本为准。
1. 打开终端，运行以下命令：
hermes setup
2. 若您为安装后首次启动，终端会显示如下信息，选择
Quick setup — provider, model & messaging (recommended)。
注意：
若您之前已配置过 Hermes Agent，则运行 hermes setup 后，终端输出可能如下图示意，此时选择 Model & Provider 即可进入模型配置。
3. 完成选择后，终端将展示可选的模型 Provider，滚动到最下面选择
Custom endpoint，按回车键确认。
4. 配置模型信息：根据终端指引逐步填写相关配置。
终端提示信息 | 配置内容 |
API base URL [e.g. https://api.example.com/v1]: | https://tokenhub.tencentmaas.com/v1 |
API key [optional]: | 填写对应的 API Key |
API compatibility mode | 选择 Chat Completions |
Model name (e.g. gpt-4, llama-3-70b): | 填写 hy3-preview |
Context length in tokens [leave blank for auto-detect]: | 填写 256000 |
Display name | 填写 hy3-preview |
Terminal backend | 根据实际情况填写，如果本地安装则选择 Local |
Gateway working directory | 根据实际需求配置，可使用默认值 |
Enable sudo support | 是否允许使用 sudo，根据需求填写，选择使用 sudo 需输入密码 |
使用 Hermes Agent
完成配置后，在终端执行
hermes 命令，即可启动 Hermes 并使用 Hy3 preview 进行对话。
说明：
Hy3 preview 默认为极速响应（no_think）模式，受 Hermes Agent 当前适配限制，暂不支持切换思考模式。
