Linux Ubuntu 安装 Hermes Agent 并接入 DeepSeek V4 教程

环境要求

• Ubuntu Linux（其他 Linux 发行版同理）
• curl、git

---

第一步：克隆仓库

cd ~
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

网络不稳定时可用浅层克隆：git clone --depth 1 https://github.com/NousResearch/hermes-agent.git

---

第二步：运行安装脚本

bash setup-hermes.sh

脚本会自动完成以下操作：

步骤	说明
安装 uv	Python 包管理器
安装 Python 3.11	通过 uv 自动安装
创建 venv	在 ~/hermes-agent/venv/
安装依赖	使用 uv.lock 哈希校验安装
配置 PATH	在 ~/.bashrc 添加 ~/.local/bin
创建命令链接	hermes → ~/hermes-agent/venv/bin/hermes

安装完成后重载 shell：

source ~/.bashrc

验证安装：

hermes --version
# 输出: Hermes Agent v0.14.0 ...

---

第三步：配置 DeepSeek API 密钥

创建 Hermes 环境变量文件：

echo "DEEPSEEK_API_KEY=你的DeepSeek_API密钥" > ~/.hermes/.env
chmod 600 ~/.hermes/.env

API 密钥在 platform.deepseek.com 获取。

---

第四步：设置 DeepSeek 为默认模型

hermes config set model "deepseek/deepseek-v4-pro"

设置之后查看 ~/.hermes/config.yaml 目录下是否存在如下内容

model: deepseek/deepseek-v4-pro

---

第五步：启动 Hermes

hermes

首次启动会自动加载 DeepSeek provider 插件，从 DeepSeek API 拉取可用模型列表。

---

模型切换

在聊天会话中：

/model               # 查看可用模型列表
/model deepseek-v4-flash    # 切换到 V4 Flash
/model deepseek-v4-pro      # 切换回 V4 Pro

支持的两个模型：

模型	说明
deepseek-v4-pro	V4 Pro — 1M 上下文，完整能力
deepseek-v4-flash	V4 Flash — 1M 上下文，快速轻量

---

原理说明

Hermes 使用 provider/model-name 格式配置模型：

• deepseek/deepseek-v4-pro
  • deepseek/ → 指定使用 plugins/model-providers/deepseek/ 插件
  • deepseek-v4-pro → 使用的具体模型名

DeepSeek provider 插件已预设：

• API 地址：https://api.deepseek.com/v1
• 环境变量：DEEPSEEK_API_KEY
• V4 系列自动启用 thinking 模式

切换模型时，provider（API 地址和密钥）不变，只更改请求中的 model 参数。

---

常用命令

hermes setup           # 运行配置向导
hermes config show     # 查看当前配置
hermes config set model "deepseek/deepseek-v4-flash"  # 设置默认模型
hermes doctor          # 诊断问题

---

注意事项

• conda 环境不影响 Hermes 运行（Hermes 使用独立的 venv）
• 如果 ~/.local/bin 不在 PATH 中，手动添加：export PATH="$HOME/.local/bin:$PATH"
• API 密钥文件 ~/.hermes/.env 权限已设为 600（仅所有者可读）