尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
Hermes Agent 安装指南
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、会话和记忆时卸载后手动删除该目录删除前确认不再需要其中的配置。
RELATED

相关推荐

LLM 数据可视化五种范式:从硬编码到 Generative UI 的 TaoToken 配置实战

LLM 数据可视化五种范式:从硬编码到 Generative UI 的 TaoToken 配置实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

📅 2026/9/25 13:26:32
树莓派本地SQLite存储DHT22温湿度数据:TaoToken统一Key接入与config.toml配置骨架

树莓派本地SQLite存储DHT22温湿度数据:TaoToken统一Key接入与config.toml配置骨架

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

📅 2026/9/25 13:21:32
B站视频下载技术原理:DASH协议与动态加密解析

B站视频下载技术原理:DASH协议与动态加密解析

1. 项目概述:为什么“下载B站视频”这件事,远比表面看起来复杂得多“下载B站视频”这六个字,是过去五年里我收到频率最高的技术咨询之一——不是因为需求小众,恰恰相反,它覆盖了从高校学生整理课程资料、自媒体创作者采…

📅 2026/9/25 13:21:32
MORE NEWS

更多资讯

📰

Server 2019 安装 Intel 无线网卡驱动失败?WLAN 服务与 INF 修改排障全攻略

这活儿其实挺有意思的。一台要当工作站的 Windows Server 2019,塞了一块 Intel Wireless-N 7265 无线网卡,结果系统死活不认。设备管理器里永远是一坨黄色感叹号,Intel 官方驱动包双击就弹"此系统不支持",我一度以为是卡…

📰

C# API限流计数一次扣2?从请求重复与中间件顺序定位修复

C# API项目里出现X-Rate-Limit-Remaining一次请求直接减2,这个问题我最近一个月里被问到了好几次。AspNetCoreRateLimit、.NET内置的RateLimiter,甚至自己写的简单计数中间件,都可能出现同一个表象:前端明明只点击了一次&#xff…

📰

C++模板编译期计算:从递归实例化到constexpr的现代实践

模板编译期计算这个话题,搁在C社区里基本就是模板元编程的代名词。我最早接触它是在读Loki库和Boost.MPL源码的时候,第一感觉是这玩意儿不像代码,更像在给编译器出谜题——你写一套规则,编译器在编译阶段替你跑完所有“计算”&…

📰

Python小屋编程题91-100复盘:语法进阶与高频陷阱解析

刷题刷到第90多道是什么感觉?微信上有个读者跟我抱怨,Python小屋的题他每道都能写出来,可一看参考解答,总觉得自己的代码又臭又长,像在拼积木,人家写的却像在盖房子。这问题太典型了。Python小屋剧本里的编…

📰

2026腾讯云服务器一年多少钱?30台CVM配置价格与选型指南

1. 为什么“一年多少钱”这个问题,从来都不是一句话能答完的每次有人问我“腾讯云服务器一年到底多少钱”,我都不会直接甩一个数字过去。不是我不想说,而是这个问题本身就问得不够精确——就像你问“买一辆车多少钱”,销售没法回答…

📰

使用 Nacos + Higress 连接 Agent 和 MCP 服务进行使用:TaoToken 统一 Key 接入配置骨架

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬