企业官网建设流程全解析

Hermes Agent 安装指南

Hermes Agent 是 Nous Research 开源的 AI Agent，提供终端、桌面应用和消息网关，支持 Windows、macOS 和 Linux。官方安装器会自动准备 uv、Python 3.11、Node.js 等依赖。PyPI 上虽然有官方hermes-agent包，但官方不支持用pip install hermes-agent安装。

Nous Portal 登录与 DeepSeek / New API Key 是可选且独立的模型接入方式。Hermes 能调用终端和文件工具，首次使用时建议保留命令审批，只启用实际需要的工具。

• 核验日期：2026-08-03

1. 安装

1.1 Windows

Windows 10/11 可从 Hermes 官网 安装 Hermes Desktop。只安装 CLI 时，在普通 PowerShell 中执行：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

无需管理员权限，也无需预先安装 Python。安装完成后关闭并重新打开 PowerShell。

1.2 macOS

Apple Silicon Mac 可从 Hermes 官网 安装 Hermes Desktop，或使用 CLI 安装器：

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

截至核验日期，macOS Intel 不在官方支持范围内。安装完成后重新打开终端。

1.3 Linux

Linux 和 WSL2 先准备 Git、curl、xz-utils，再运行官方安装器。Ubuntu / Debian 示例：

sudo apt update sudo apt install -y git curl xz-utils curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

安装完成后重新打开终端；当前终端尚未刷新时，可执行：

source ~/.bashrc # Zsh 用户改为 source ~/.zshrc

标准安装器可能在末尾进入配置向导；也可先退出，完成“验证”后再按“配置”章节运行。

2. 验证

hermes --version

能够输出 Hermes Agent 版本号，即表示安装成功。尚未配置模型或 API Key 不影响此项验证。

3. 配置

3.1 账号登录

使用 Nous Portal 账号登录并由向导选择模型、工具时，执行：

hermes setup --portal

命令会打开浏览器完成 Nous Portal 登录。需要重新运行完整配置向导时使用：

hermes setup

DeepSeek 和 New API 在 Hermes 中通常使用 API Key，不属于 Hermes 账号登录。

3.2 API Key（DeepSeek / New API 示例）

Hermes 的非敏感设置与密钥分开保存。除非设置了HERMES_HOME，三个系统都使用当前用户主目录下的.hermes：

%LOCALAPPDATA%\hermes\是 Windows 原生安装的程序目录之一，不是默认的用户配置目录。下面的 DeepSeek 直连和 New API 是两套可选配置；一次只将其中一套设为model.provider。

DeepSeek 示例：直连 DeepSeek，并将deepseek-v4-pro设为默认模型。

在.env中保存密钥：

DEEPSEEK_API_KEY=你的_DeepSeek_API_Key

在config.yaml中合并模型配置：

model: provider: deepseek default: deepseek-v4-pro

字段含义：

• provider: deepseek：使用 Hermes 内置的 DeepSeek 提供商，并读取.env中的DEEPSEEK_API_KEY。
• default: deepseek-v4-pro：指定实际请求的模型 ID；要使用低成本模型可改为 DeepSeek 当前开放的其他 ID。
• 内置提供商已经带有 DeepSeek 官方 API 基址，直连时无需在config.yaml重复填写base_url。只有使用私有镜像时，才在.env中另设DEEPSEEK_BASE_URL=https://镜像地址/v1。

更推荐运行hermes model，选择DeepSeek，按向导填写https://api.deepseek.com并选择deepseek-v4-pro；向导会把密钥和模型分别写入上述用户文件。

New API 示例：通过 OpenAI Chat Completions 兼容接口使用deepseek-v4-pro。

该示例只适用于 New API 控制台确实向当前令牌开放deepseek-v4-pro，并且站点实现了POST /v1/chat/completions、流式输出和工具调用的情况。在.env中加入：

NEWAPI_API_KEY=你的_NewAPI_令牌

在config.yaml中加入一个命名的自定义提供商，并将它设为默认：

providers: newapi: api: https://你的NewAPI域名/v1 key_env: NEWAPI_API_KEY transport: chat_completions model: provider: custom:newapi default: deepseek-v4-pro

字段含义：

• providers.newapi：定义名为newapi的自定义提供商。
• api：填写包含/v1的 API 基址，不要填写完整的/v1/chat/completions路径。
• key_env：让 Hermes 从.env的NEWAPI_API_KEY读取令牌，避免把密钥直接写进 YAML。
• transport: chat_completions：指定 OpenAI Chat Completions 协议；只有 Responses 接口的网关不能使用此示例。
• provider: custom:newapi：选择上方providers.newapi；两处名称必须一致。
• default：必须与 New API 控制台显示的准确模型 ID 一致。Base URL 不会自动选择或转换模型。

Hermes 的完整 Agent 会携带系统提示、工具定义和对话历史。自定义网关应开放足够大的上下文窗口；若模型上下文过小，即使简单 API 测试成功，Agent 任务仍可能失败。

保存并验证：

1. 确认config.yaml缩进正确，并且对应密钥已经写入同目录的.env。
2. 完全退出正在运行的 Hermes CLI、Desktop 或 Gateway 进程，然后重新打开终端或应用。
3. 先运行配置检查：

hermes config check

1. 根据启用的方案运行一次对话：

# DeepSeek 直连 hermes chat --provider deepseek --model deepseek-v4-pro # New API hermes chat --provider custom:newapi --model deepseek-v4-pro

启动页显示目标提供商和模型，且消息能够正常返回，说明配置已经生效。如果 New API 的模型 ID 不同，应同时替换 YAML 的default和命令中的--model。

不要使用旧文档中的config.toml、HERMES_API_KEY或顶层custom_providers旧格式，也不要把 API Key 直接写进config.yaml。.env包含明文密钥，不能提交到 Git、网盘同步目录或聊天记录。第三方网关不是 Nous Research 或 DeepSeek 官方服务，使用前应核对模型真实性、计费、日志留存和数据处理规则。

4. 更新

先检查更新，再执行更新：

hermes update --check hermes update hermes --version

Windows 更新前先退出 Hermes Desktop 和其他 Hermes 会话。不要使用pip install --upgrade hermes-agent更新由官方安装器管理的版本。

5. 卸载

CLI 使用官方内置卸载命令，它会移除程序文件、命令链接和自启动项，并询问是否保留配置文件：

hermes uninstall

• Windows：该命令会移除计划任务、启动文件夹快捷方式、hermes.cmd垫片和%LOCALAPPDATA%\hermes\hermes-agent\，并从用户 PATH 中移除相关条目。
• Hermes Desktop（图形界面）：按系统常规方式卸载桌面应用（Windows 在设置 → 应用中卸载，macOS 将应用拖入废纸篓），再运行上面的 CLI 卸载命令清理命令行部分。

配置和登录数据默认保留在~/.hermes/（Windows 为%USERPROFILE%\.hermes\）。需要彻底清除（含 API Key、会话和记忆）时，卸载后手动删除该目录；删除前确认不再需要其中的配置。