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

# Hermes Agent

> 将 Venice 配置为 Hermes Agent 的模型提供方，获得具备持久化记忆、自定义技能和多平台消息能力的私有、无审查 AI。

[Hermes Agent](https://hermes-agent.nousresearch.com) 是由 [Nous Research](https://nousresearch.com) 构建的开源、自托管 AI agent。它具备持久记忆、自主创建 skill 的能力，以及内置的学习循环，运行时间越长能力越强。将其指向 Venice API，您的 agent 即可访问 230+ 个文本、图像、视频、音频、embeddings 等领域的模型和工具。

<Card title="Hermes Agent 文档" icon="arrow-up-right-from-square" href="https://hermes-agent.nousresearch.com/docs/">
  完整文档、提供商设置和配置选项请参阅 Hermes Agent 官方文档。
</Card>

## 为何选择 Venice + Hermes Agent？

Venice API 通过单一 OpenAI 兼容端点为您的 Hermes Agent 提供 Venice 平台的完整能力。

| 能力             | 您将获得                            |
| -------------- | ------------------------------- |
| **文本和聊天**      | 私有和匿名化模型（GLM、Qwen、Claude、GPT 等） |
| **图像**         | 生成、编辑、放大和背景移除                   |
| **视频**         | 生成和转录                           |
| **音频**         | 语音合成（TTS）、音乐生成和语音转文本            |
| **Embeddings** | 用于 RAG 和语义搜索的向量 embeddings      |
| **工具**         | Web 抓取、Web 搜索、文本解析和 crypto RPC  |

<CardGroup cols={3}>
  <Card title="私有推理" icon="shield-halved">
    零数据保留。Prompt 永远不会被存储或记录
  </Card>

  <Card title="持久记忆" icon="brain">
    Hermes 在会话和重启之间记住上下文
  </Card>

  <Card title="15+ 平台" icon="comments">
    在 Telegram、Discord、Slack、WhatsApp 等平台访问您的 agent
  </Card>
</CardGroup>

## 设置

### 1. 安装 Hermes Agent

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={"system"}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```
  </Tab>

  <Tab title="WSL2 (Windows)">
    先安装 [WSL2](https://learn.microsoft.com/en-us/windows/wsl/install)，然后运行相同的命令：

    ```bash theme={"system"}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```
  </Tab>
</Tabs>

安装后，重新加载您的 shell：

```bash theme={"system"}
source ~/.zshrc   # or: source ~/.bashrc
```

### 2. 将 Venice 配置为您的提供商

运行模型设置向导：

```bash theme={"system"}
hermes model
```

选择 **Custom endpoint (self-hosted / VLLM / etc.)** 并在出现提示时输入以下内容：

| 字段               | 值                              |
| ---------------- | ------------------------------ |
| **API base URL** | `https://api.venice.ai/api/v1` |
| **API key**      | 您的 Venice API 密钥               |
| **Model name**   | Venice 模型 ID（见下文）              |

如果您还没有 API 密钥，可以从 [venice.ai/settings/api](https://venice.ai/settings/api) 获取。

<Tip>
  您也可以直接在 `~/.hermes/config.yaml` 中配置 Venice：

  ```yaml theme={"system"}
  model:
    default: zai-org-glm-5
    provider: custom
    base_url: https://api.venice.ai/api/v1
    api_key: ${VENICE_API_KEY}
  ```

  并在 `~/.hermes/.env` 中设置密钥：

  ```bash theme={"system"}
  VENICE_API_KEY=your-key-here
  ```
</Tip>

### 3. 选择模型

当向导要求选择模型时，根据您的用例选择一个：

| 用例  | 模型                      | 隐私         |
| --- | ----------------------- | ---------- |
| 通用  | `zai-org-glm-5`         | Private    |
| 推理  | `kimi-k2-6`             | Private    |
| 编码  | `claude-opus-4-7`       | Anonymized |
| 视觉  | `z-ai-glm-5v-turbo`     | Anonymized |
| 无审查 | `venice-uncensored-1-2` | Private    |

随时无需重启即可更改模型：

```bash theme={"system"}
hermes model              # 完整向导
```

或在会话中切换：

```text theme={"system"}
/model custom:claude-opus-4-7
```

### 4. 开始聊天

打开经典 CLI 或现代 TUI：

```bash theme={"system"}
hermes            # 经典 CLI
hermes --tui      # 现代 TUI（推荐）
```

尝试一个 prompt 验证一切是否正常：

```text theme={"system"}
Summarize this repo in 5 bullets and tell me what the main entrypoint is.
```

## 连接消息平台

CLI 工作后，通过网关连接您的消息应用：

```bash theme={"system"}
hermes gateway setup
```

这将引导您连接 Telegram、Discord、Slack、WhatsApp、Signal 和其他平台。您的 agent 将可从任何已连接的渠道访问，全部由 Venice 驱动。

```bash theme={"system"}
hermes gateway      # 启动消息网关
```

## 隐私模式

Hermes Agent 中的 Venice 模型遵循与 Venice API 相同的[隐私等级](/overview/privacy)：

* **Private** 模型（GLM、Qwen、DeepSeek、Llama、Venice Uncensored）在 Venice 的 GPU 集群上运行。Prompt 永远不会被存储或记录。
* **Anonymized** 模型（Claude、GPT、Gemini、Grok）通过 Venice 代理，并剥离所有身份信息。第三方提供商看到的客户是 Venice，而不是您。

## Venice API skills

Hermes Agent 具有内置的 skills 系统，与 [Agent Skills](https://github.com/veniceai/skills) 格式兼容。Venice 发布了官方 skills，教您的 agent 如何使用每个 Venice 端点（聊天、图像生成、视频、音频、embeddings、augment 工具等）。

直接从 GitHub 安装 Venice skills：

```bash theme={"system"}
hermes skills install veniceai/skills
```

或搜索单个 skill：

```bash theme={"system"}
hermes skills search venice
```

Hermes 将通过每个 skill 的 `SKILL.md` frontmatter 发现并按需加载它们。

## 关键命令

| 命令                  | 说明       |
| ------------------- | -------- |
| `hermes`            | 开始聊天     |
| `hermes model`      | 更改提供商或模型 |
| `hermes tools`      | 配置启用哪些工具 |
| `hermes gateway`    | 启动消息网关   |
| `hermes --continue` | 恢复上次会话   |
| `hermes doctor`     | 诊断问题     |
| `hermes update`     | 更新到最新版本  |

## 资源

<CardGroup cols={2}>
  <Card title="Hermes Agent 文档" icon="book" href="https://hermes-agent.nousresearch.com/docs/">
    官方文档
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/NousResearch/hermes-agent">
    源代码和发布
  </Card>

  <Card title="Venice 模型目录" icon="list" href="/models/text">
    浏览可用模型
  </Card>

  <Card title="Venice 隐私" icon="shield-halved" href="/overview/privacy">
    Venice 如何保护您的数据
  </Card>
</CardGroup>