跳转到主要内容
通过 Hermes 的自定义 OpenAI-compatible endpoint 支持，将 CometAPI 用作 Hermes Agent 的模型提供方。

​
前提条件

  • Git
  • 拥有有效 API key 的 CometAPI 账户
  • macOS、Linux 或 WSL2 上的终端

​
安装

1

获取你的 CometAPI API key

登录 CometAPI 控制台。点击 Add API Key 并复制你的 <COMETAPI_KEY> 密钥。
显示 Add API Key 按钮的 CometAPI 控制台
显示 base URL 的 CometAPI API key 详情
2

安装 Hermes Agent

以下命令会运行官方安装程序：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
如果当前 shell 还无法识别 hermes 命令，请重新加载 shell 配置：
source ~/.zshrc
# or
source ~/.bashrc
Hermes 会将配置存储在 ~/.hermes/ 中，将 hermes 命令链接到 ~/.local/bin，并且可能会将 ~/.local/bin 添加到你的 shell PATH 中。

​
配置

1

存储你的 CometAPI key

打开 ~/.hermes/.env 并添加以下一行：
OPENAI_API_KEY=<COMETAPI_KEY>
Hermes 会将 OPENAI_API_KEY 用作自定义 OpenAI-compatible endpoints 的认证回退项。
2

配置 CometAPI endpoint

打开 ~/.hermes/config.yaml 并确保 model 部分如下所示：
model:
  provider: custom
  default: your-model-id
  base_url: https://api.cometapi.com/v1
将 your-model-id 替换为 CometAPI Models 页面 上当前可用的文本 model ID。
请将 API key 保留在 ~/.hermes/.env 中。不要在 config.yaml 中硬编码密钥。
此设置会配置主聊天模型。Hermes 可以为视觉或网页提取等任务使用单独的辅助模型。

​
验证

1

检查配置

以下命令可确认 Hermes 能够读取配置和 API key：
hermes config check
hermes doctor
hermes status
如果 hermes config check 在更新后报告缺少选项，请运行 hermes config migrate，然后再次检查。
2

运行真实聊天测试

以下命令会通过 CometAPI 发送一个真实请求：
hermes chat -q "Reply with the single word CONNECTED."
如果设置成功，将返回 CONNECTED，且不会出现认证或 endpoint 错误。

​
可选配置

如果你要替换旧版 Hermes 安装，请先使用内置卸载程序：
hermes uninstall
在卸载程序中，选择 Full uninstall 以移除 CLI、PATH 条目以及 ~/.hermes/ 数据。然后重新执行安装步骤，并继续使用相同的 CometAPI 配置。
如果你更喜欢交互式流程，请运行 hermes model 并选择 Custom endpoint。然后输入以下值：
  • Base URL: https://api.cometapi.com/v1
  • API key: 你的 CometAPI API key
  • Model: 当前可用的 CometAPI 文本 model ID
此流程会将相同的 provider 设置写入 config.yaml。