Hermes

将 Hermes 接入 DeepSeek API

作者
DeepSeekAgent.io 编辑部
发布
更新

Hermes 是 Nous Research 打造的开源自我进化 AI Agent。它内置学习闭环：能够从经验中生成技能，在使用过程中持续优化，沉淀知识，并在跨会话中逐步构建你偏好的动态模型。

1. 安装 Hermes

快速安装

通过一行安装命令，你可以在两分钟内快速启动 Hermes Agent。

Linux / macOS / WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

唯一前置依赖是 Git，其余内容安装脚本会自动处理。

更多安装说明请参考 Hermes 安装文档。

2. 配置 DeepSeek 模型

安装完成并重新加载 Shell 后，在普通终端中运行：

hermes model

hermes model 是当前完整的模型配置入口，可以添加 Provider、录入 API Key 并选择模型。按照交互提示选择 DeepSeek，然后输入你的 DeepSeek API Key。Hermes 会把 DeepSeek Provider 写入配置，不需要手工固定旧模型 ID。

也可以把 Key 写入 Hermes 的环境文件：

mkdir -p ~/.hermes
printf 'DEEPSEEK_API_KEY=%s\n' '你的 API Key' >> ~/.hermes/.env
hermes model

请不要把真实 Key 直接提交到项目仓库。配置完成后，启动 Hermes：

hermes

会话内的 /model 只用于切换已经配置好的 Provider 和模型；第一次添加 DeepSeek，或需要修改 Endpoint 与凭据时，应退出会话后运行 hermes model。

3. 使用兼容 API Endpoint

如果使用 DeepSeek 兼容 API，而不是 Hermes 内置的 DeepSeek Provider，可在 hermes model 中选择 Custom endpoint，填写服务提供方给出的 Base URL、API Key 和模型 ID。模型名称以该服务实际开放的列表为准，不要沿用旧教程中的 deepseek-v4-pro。

需要一个用于测试的兼容 API Key，可以前往免费 DeepSeek API 额度页面领取并查看当前支持的模型。

4. 常用检查

  • Provider 或模型需要重新配置：在会话外运行 hermes model。
  • 已配置多个模型，需要临时切换：在会话中运行 /model。
  • Key 已写入但没有生效：确认文件位于 ~/.hermes/.env，然后重新启动 Hermes。
  • 自定义服务连接失败：检查 Base URL 是否包含服务要求的版本路径，以及模型 ID 是否与服务端完全一致。

参考资料