> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes 接入 PPIO LLM API

Hermes 是 Nous Research 推出的 Agent 工具，支持通过自定义 OpenAI-compatible endpoint 连接模型服务。本文介绍如何在 Hermes 中接入 PPIO 派欧云的大语言模型 API。

## 前置准备

开始前，请先准备以下信息：

* **API Key**：前往 [API 密钥管理](https://ppio.com/settings/key-management) 创建或复制 API Key。
* **Base URL**：`https://api.ppio.com/openai/v1`
* **Model ID**：前往模型广场或模型详情页，复制需要使用的模型 ID，例如 `deepseek/deepseek-v3.1`。

<Tip>
  Hermes 会在本地保存您的 endpoint 与 API Key 配置。请不要把包含密钥的配置文件提交到 Git 仓库。
</Tip>

## 安装 Hermes

Hermes 提供终端版与桌面版。您可以按需选择一种方式安装。

### Linux / macOS / WSL2

```bash theme={null}
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
```

### Windows PowerShell

```bash theme={null}
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
```

### Desktop

您也可以访问 Hermes Desktop 页面下载安装：

```text theme={null}
https://hermes-agent.nousresearch.com/desktop
```

## 配置 PPIO endpoint

安装完成后，运行 Hermes 的配置向导。不同版本的命令入口可能略有差异，请以 Hermes 终端提示为准。

在配置过程中，按以下方式选择和填写：

1. 选择 **Custom endpoint** 或手动输入 URL 的自定义提供商。
2. 在 Base URL 中填写：`https://api.ppio.com/openai/v1`
3. 在 API Key 中填写您的 PPIO API Key。
4. 在 API 类型中选择默认自动检测。如果需要手动指定，请选择 OpenAI-compatible / Chat Completions 相关模式。
5. 在模型列表中选择目标模型，或手动输入 PPIO 模型 ID，例如 `deepseek/deepseek-v3.1`。
6. 根据模型上下文长度设置 max tokens；不确定时可以保留默认或自动检测。
7. 为该模型配置设置一个便于识别的名称，例如 `ppio-deepseek-v3.1`。
8. 如果仅在本地使用，运行环境选择默认的 Local。
9. 如果不需要连接 Telegram、Slack、Matrix 等渠道，集成渠道保持跳过即可。

## 刷新终端配置

如果 Hermes 安装完成后提示需要刷新 shell，请执行：

```bash theme={null}
source ~/.zshrc
```

## 启动 Hermes

在终端中启动 Hermes：

```bash theme={null}
hermes
```

输入一条测试消息，例如：

```text theme={null}
你好，请介绍一下当前连接的模型能力。
```

如果请求失败，请检查：

* API Key 是否填写正确。
* Base URL 是否为 `https://api.ppio.com/openai/v1`。
* 模型 ID 是否与 PPIO 模型详情页保持一致。
* 当前选择的 API 类型是否兼容 OpenAI-compatible endpoint。