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-031. 安装1.1 WindowsWindows 10/11 可从 Hermes 官网 安装 Hermes Desktop。只安装 CLI 时在普通 PowerShell 中执行iex (irm https://hermes-agent.nousresearch.com/install.ps1)无需管理员权限也无需预先安装 Python。安装完成后关闭并重新打开 PowerShell。1.2 macOSApple Silicon Mac 可从 Hermes 官网 安装 Hermes Desktop或使用 CLI 安装器curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash截至核验日期macOS Intel 不在官方支持范围内。安装完成后重新打开终端。1.3 LinuxLinux 和 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 setupDeepSeek 和 New API 在 Hermes 中通常使用 API Key不属于 Hermes 账号登录。3.2 API KeyDeepSeek / New API 示例Hermes 的非敏感设置与密钥分开保存。除非设置了HERMES_HOME三个系统都使用当前用户主目录下的.hermes系统模型配置密钥文件Windows 原生%USERPROFILE%\.hermes\config.yaml%USERPROFILE%\.hermes\.envmacOS / Linux / WSL2~/.hermes/config.yaml~/.hermes/.env%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_URLhttps://镜像地址/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 任务仍可能失败。保存并验证确认config.yaml缩进正确并且对应密钥已经写入同目录的.env。完全退出正在运行的 Hermes CLI、Desktop 或 Gateway 进程然后重新打开终端或应用。先运行配置检查hermes config check根据启用的方案运行一次对话# 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 --versionWindows 更新前先退出 Hermes Desktop 和其他 Hermes 会话。不要使用pip install --upgrade hermes-agent更新由官方安装器管理的版本。5. 卸载CLI 使用官方内置卸载命令它会移除程序文件、命令链接和自启动项并询问是否保留配置文件hermes uninstallWindows该命令会移除计划任务、启动文件夹快捷方式、hermes.cmd垫片和%LOCALAPPDATA%\hermes\hermes-agent\并从用户 PATH 中移除相关条目。Hermes Desktop图形界面按系统常规方式卸载桌面应用Windows 在设置 → 应用中卸载macOS 将应用拖入废纸篓再运行上面的 CLI 卸载命令清理命令行部分。配置和登录数据默认保留在~/.hermes/Windows 为%USERPROFILE%\.hermes\。需要彻底清除含 API Key、会话和记忆时卸载后手动删除该目录删除前确认不再需要其中的配置。
