Hermes 是 Nous Research 推出的 Agent 工具，支持通过自定义 OpenAI-compatible endpoint 连接模型服务。本文介绍如何在 Hermes 中接入 PPIO 派欧云的大语言模型 API。
前置准备
开始前，请先准备以下信息：
- API Key：前往 API 密钥管理 创建或复制 API Key。
- Base URL：
https://api.ppio.com/openai/v1
- Model ID：前往模型广场或模型详情页，复制需要使用的模型 ID，例如
deepseek/deepseek-v3.1。
Hermes 会在本地保存您的 endpoint 与 API Key 配置。请不要把包含密钥的配置文件提交到 Git 仓库。
安装 Hermes
Hermes 提供终端版与桌面版。您可以按需选择一种方式安装。
Linux / macOS / WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Windows PowerShell
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
Desktop
您也可以访问 Hermes Desktop 页面下载安装：
https://hermes-agent.nousresearch.com/desktop
配置 PPIO endpoint
安装完成后，运行 Hermes 的配置向导。不同版本的命令入口可能略有差异，请以 Hermes 终端提示为准。
在配置过程中，按以下方式选择和填写：
- 选择 Custom endpoint 或手动输入 URL 的自定义提供商。
- 在 Base URL 中填写：
https://api.ppio.com/openai/v1
- 在 API Key 中填写您的 PPIO API Key。
- 在 API 类型中选择默认自动检测。如果需要手动指定，请选择 OpenAI-compatible / Chat Completions 相关模式。
- 在模型列表中选择目标模型，或手动输入 PPIO 模型 ID，例如
deepseek/deepseek-v3.1。
- 根据模型上下文长度设置 max tokens；不确定时可以保留默认或自动检测。
- 为该模型配置设置一个便于识别的名称，例如
ppio-deepseek-v3.1。
- 如果仅在本地使用，运行环境选择默认的 Local。
- 如果不需要连接 Telegram、Slack、Matrix 等渠道，集成渠道保持跳过即可。
刷新终端配置
如果 Hermes 安装完成后提示需要刷新 shell，请执行：
启动 Hermes
在终端中启动 Hermes：
输入一条测试消息，例如：
如果请求失败，请检查：
- API Key 是否填写正确。
- Base URL 是否为
https://api.ppio.com/openai/v1。
- 模型 ID 是否与 PPIO 模型详情页保持一致。
- 当前选择的 API 类型是否兼容 OpenAI-compatible endpoint。
