【保姆级】Hermes Agent安装指南:一条命令,10分钟接上DeepSeek

〇、导语

本文主要讲解：在一台干净的 Ubuntu 上从零装好 Hermes Agent，再接入国内最容易拿到的 DeepSeek 大模型。全程一条安装命令加一个 API Key，实测 10 分钟以内跑通。

动手之前先交代两件事：Hermes 能跑在哪些系统上，以及它有哪些「脸」。官方把平台分两档：一等平台（Tier 1）包括 macOS（Apple Silicon）、Windows 10/11、Linux / WSL2 和 Docker 容器，Linux 上安装只要求 git、curl、xz-utils 三个前置包；次一档（Tier 2）是 Android 的 Termux（部分功能不可用）和 Nix / NixOS（官方自嘲「经常坏」）。能铺这么宽，靠的是 Python 3.11 运行时加 uv 管依赖，跨平台成本低；官方测试基准就是「最新的 Ubuntu 和 WSL2」。

界面这边，官方原话是「几个前端都接同一个 agent」：终端有 CLI（hermes）和 TUI（hermes --tui），桌面有原生应用 Hermes Desktop（hermes desktop 直接拉起，Linux 上需先装 build-essential），浏览器有 Web 仪表盘（hermes dashboard），还能接 Telegram、Discord 等消息平台，或用 OpenAI 兼容 API 接 Open WebUI 这类任意前端、嵌进 VS Code 等 IDE。所有界面共享同一套配置、会话和记忆，终端里聊到一半的话题，切到桌面应用还能接着聊。

为什么教程选 Ubuntu？一是 Linux 是一等平台，官方实测对象就是最新 Ubuntu，读者照抄成功率最高；二是依赖齐整，apt 一条命令装完 git、curl、xz-utils，和安装器的要求严丝合缝；三是服务器场景，$5 档云服务器的默认系统基本都是 Ubuntu，本机配好后搬到云上跑定时任务不用换系统。本文所有命令均在 Ubuntu 26.04 x86_64 上真实执行验证。

为什么配 DeepSeek？官方 API 国内直连、价格便宜（deepseek-v4-flash 输出约 $0.28/百万 token，2026-08-16 起还引入峰谷计价）、模型能力足够驱动 agent 干活。对预算敏感的开发者，这是目前性价比最高的组合。

一、安装前的准备

1.1 系统要求

官方文档明确：安装器支持 Linux / macOS / WSL2 / Android（Termux），Ubuntu 是完整支持的一等平台。硬件上没有特殊要求，官方建议甚至可以部署在 $5/月的云服务器上，对内存的要求远比跑本地模型低。

安装器会自动处理大部分依赖，你只需要预先装好 git、curl、xz-utils。安装器会帮你装：uv（Python 包管理器）、Python 3.11、Node.js v22（浏览器自动化用）、ripgrep、ffmpeg。

1.2 检查前置依赖

sudo apt update && sudo apt install -y git curl xz-utilsgit --versioncurl --version | head -1

实测输出如下（截图 01）：

Git 必须存在，安装器依赖它克隆仓库；curl 和 xz-utils 用于下载 Node.js 的 tar.xz 压缩包。

二、正式安装

2.1 一条命令安装

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

Windows 用户对应命令是 iex (irm https://hermes-agent.nousresearch.com/install.ps1)，本文只讲 Ubuntu。

安装器的工作流程（截图 02）：检测系统依赖 → git clone 源码到 ~/.hermes/hermes-agent/ → 用 uv 装 Python 3.11 → 创建虚拟环境 → 装 Python 依赖 → 装 Node.js 与浏览器依赖 → 把 hermes 命令链接到 ~/.local/bin/ → 生成初始配置。中途会询问是否配置 API Key，可以先跳过（选 N），下一步手动配 DeepSeek 更清晰。

安装脚本本身是开源的，官方直接托管在官网，可以先下载看一眼再执行（截图 03 是脚本真实开头）：

2.2 安装后布局

装完后的目录结构如下（截图 04）：

~/.hermes/hermes-agent/
：源码仓库（git 安装方式）；
~/.hermes/config.yaml
：主配置，模型、Provider、工具开关都在这里；
~/.hermes/.env
：API Key 等密钥（不进 git，注意备份）；
~/.hermes/skills/
、memories/：技能与记忆，agent 自学习的载体。

2.3 验证安装

source ~/.bashrchermes --version

如果看到版本号输出（本机为 v0.18.2），说明命令已生效（截图 05）：

三、配置 DeepSeek

3.1 获取 API Key

3.2 写入环境变量文件

Hermes 的密钥统一存在 ~/.hermes/.env。先查路径，再追加两行：

hermes config env-path# 输出 .env 路径，默认 ~/.hermes/.envecho 'DEEPSEEK_API_KEY=sk-你的Key' >> ~/.hermes/.envecho 'DEEPSEEK_BASE_URL=https://api.deepseek.com' >> ~/.hermes/.env

实测输出与文件内容如下（截图 06，Key 是sk-开头的部分）：

说明：DEEPSEEK_API_KEY 是官方文档指定的环境变量名；DEEPSEEK_BASE_URL 指向 DeepSeek 官方 OpenAI 兼容端点（https://api.deepseek.com，文档标注的 OpenAI 格式地址，等价写法 https://api.deepseek.com/v1）。

3.3 用 hermes model 选定模型

hermes model 是交互式选择器，列出所有支持的 Provider。选择 DeepSeek，模型填 deepseek-v4-flash（官方当前主力模型，1M 上下文，性价比最高；想要更强推理就选 deepseek-v4-pro）：

hermes model

选择器帮助信息如下（截图 07）：

3.4 确认配置

hermes config

看到 Model 一栏显示 deepseek-v4-flash、Provider deepseek、base_url https://api.deepseek.com 即配置成功（截图 08）：

四、健康检查与首次对话

4.1 hermes doctor 体检

hermes doctor 会全面检查环境：Python 版本、配置文件、依赖包、API 连通性。重点看最后几行的 API Connectivity 部分，DeepSeek 出现 ✓ 就代表 Key 和网络都没问题（截图 09、10）：

4.2 首次对话

hermes

进入交互界面后直接提问即可。或者用单次查询模式快速验证：

hermes chat -q ”你是通过什么模型运行的？”

本机实测返回（截图 11，真实输出）：

输出显示 "我当前运行在 deepseek 的 deepseek-v4-flash 模型上"，配置完全生效。

五、日常使用要点

换模型：会话中输入 /model 随时切换，同一套工具不换。

常用命令：

命令	作用
`hermes`	进入交互对话
`hermes chat -q "问题"`	单次查询，脚本友好
`hermes doctor`	健康检查
`hermes model`	切换模型与 Provider
`hermes tools`	开关工具集
`hermes cron create '0 9 * * *'`	创建定时任务
`hermes gateway setup`	接入 Telegram 等平台

定时任务示例：每天早上 9 点让 agent 汇总昨日 GitHub 动态并发到 Telegram，一条命令建好，之后它自己跑。

六、常见问题

Q：安装时报 git 找不到？A：先执行 sudo apt install -y git 再重跑安装命令。

Q：国内网络安装慢或失败？A：安装器会下载 GitHub 仓库与 astral.sh 的 uv，国内可能较慢。可重试（脚本支持断点续传语义），或设置代理后重跑：export https_proxy=http://你的代理:端口再执行安装命令。DeepSeek API 本身国内直连无碍。

Q：hermes 命令找不到？A：安装器把命令放在 ~/.local/bin/，确认该目录在 PATH 中：export PATH="$HOME/.local/bin:$PATH" 并写入 ~/.bashrc。

Q：doctor 显示 DeepSeek 未连通？A：检查 .env 里 Key 是否完整复制（sk- 开头、无空格），再执行 source ~/.bashrc 重载环境；确认账户有余额。

Q：想换回官方建议的 Nous Portal？A：hermes setup --portal 一次 OAuth 登录覆盖 300+ 模型，适合不想逐家申请 Key 的用户；本文的 DeepSeek 直连方案零订阅费，更适合按量付费用户。

七、参考资料

Hermes 安装指南：https://hermes-agent.nousresearch.com/docs/getting-started/installation
Hermes Provider 文档（DeepSeek 节）：https://hermes-agent.nousresearch.com/docs/integrations/providers
DeepSeek 官方文档与定价：https://api-docs.deepseek.com/quick_start/pricing
DeepSeek 开放平台：https://platform.deepseek.com
Hermes 官方文档首页：https://hermes-agent.nousresearch.com/docs/