Hermes Agent 安装很简单:在 Linux、macOS 或 Windows WSL2 上跑一条官方 curl 脚本就能完成,脚本会顺手装好 uv、Python 3.11 并拉起配置向导。它是 Nous Research 推出的开源、免费、可自托管 AI 智能体,本文整理完整安装步骤与系统要求。 Hermes Agent官方安装入口
Hermes Agent 由 Nous Research 开发并在 GitHub 开源(仓库为 NousResearch/hermes-agent),安装脚本、更新日志与文档都从这份官方仓库出发。官方文档站(hermes-ai.net 的 Quickstart 页面)给出了从安装到配置的全流程指引,安装命令也以官方文档记载的为准。
- 官方源码仓库:NousResearch/hermes-agent,安装脚本与版本更新都从这里拉取;
- 官方文档站:hermes-ai.net 的 Quickstart,适合边看边装;
- 适用人群:想自托管 AI 智能体、跑自动化任务或做训练数据生成的开发者与技术用户。
认准官方渠道:安装脚本只从官方仓库获取,建议直接从官方文档页复制命令,不要经第三方下载站或论坛转手拿修改版。
Hermes Agent怎么安装
整个流程就五步,先装后配再启动:
- 准备一台能联网的机器,系统是 Linux、macOS,或装了 WSL2 的 Windows;
- 拉取官方安装脚本并查看内容:
curl -fsSLO https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh 后执行 less install.sh 确认无误;
- 运行安装:
bash install.sh,脚本会自动安装 uv、Python 3.11 并克隆仓库;
- 重新加载 shell:
source ~/.bashrc(用 zsh 就改 source ~/.zshrc),让 hermes 命令生效;
- 跑初始化向导
hermes setup,按提示选好 LLM 提供商、填 API key 或 OpenAI 兼容端点,最后输入 hermes 启动对话。
两点提醒:脚本全程不需要 sudo,依赖都装进用户目录;官方文档也提供一行直装写法 curl -fsSL … | bash,但先看一眼脚本再执行更稳妥,避免装上被改过的版本。
Hermes Agent支持的系统要求
官方明确支持三大环境,核心门槛如下:
| |
|---|
| Linux、macOS,以及 Windows 上的 WSL2 |
| 仍是实验性,官方建议走 WSL2 而不是裸 Windows |
| 脚本自动装 uv 与 Python 3.11,无需提前预装 |
| |
| |
具体自动安装的 Python 版本、依赖清单会随仓库迭代变化,安装前以官方文档当期说明为准。
Hermes Agent收费吗与开源授权
Hermes Agent 本身开源免费。据官方说明,项目采用 MIT 许可,代码完全公开,可永久免费自托管,数据留在你自己的机器上,没有遥测、没有追踪、也没有云端绑定。
需要留意的是,Hermes 只是个智能体框架,真正干活要靠背后的大模型。无论是接 OpenRouter、Anthropic、OpenAI 还是本地模型,模型调用费都按各家提供商的标准另算,这部分不在 Hermes 的收费范围内。纯部署和使用 Hermes 本体不花钱。 Hermes Agent安装的注意事项
- 脚本只信官方:安装命令从官方仓库复制,先
less install.sh 看一遍再执行,别用来路不明的镜像。
- Windows 走 WSL2:原生 Windows 支持尚不稳定,装 WSL2 再跑 Linux 安装命令最省心。
- 先备好模型凭证:装完只是第一步,没有配置可用的 LLM(API key 或兼容端点)就起不了对话,装之前先把 key 准备好。
- 配置都在本地:所有设置、记忆、技能都存在
~/.hermes/ 目录,重装或换机器前记得备份这个文件夹。
- 装完自检用 doctor:遇到配置或环境报错,跑
hermes doctor 能快速定位问题,比盲目重装高效。
- 升级走官方命令:更新用
hermes update,它会拉最新代码并重装依赖,别手动改核心文件以免下次更新冲突。
Hermes Agent安装常见问题
Q:Hermes Agent 本身收费吗?
A:不收费,MIT 开源、可永久免费自托管;只有背后大模型的调用费按提供商另算。
Q:支持哪些操作系统?
A:官方支持 Linux、macOS 和 Windows WSL2,原生 Windows 仍是实验性,建议用 WSL2。
Q:安装需要 sudo 或 root 权限吗?
A:不需要。脚本会把 uv、Python 等依赖装进用户目录,普通账号就能跑完。
Q:没有 API key 能先装上吗?
A:能装,但配置向导不填可用模型就进不了对话,建议装之前先备好 key 或兼容端点。
Q:装完文件都放哪了?
A:全部在 ~/.hermes/ 目录下,含 config.yaml、记忆、技能与日志,换机前备份它即可。
Q:Windows 用户怎么装最稳?
A:先装 WSL2,打开 Ubuntu 终端,再执行和 Linux 一样的 curl 安装命令,依赖处理更顺。
Q:安装失败或启动报错怎么办?
A:先确认系统是 Linux/macOS/WSL2 且能联网,再跑 hermes doctor 看诊断;仍不行就重跑安装脚本。
Q:能接哪些大模型?
A:支持 OpenRouter、Anthropic、OpenAI、本地模型等多种 LLM 提供商,配置时用 hermes model 切换。
Q:我的聊天记录和记忆安全吗?
A:数据留在本地机器,官方强调无遥测无云端锁定;敏感信息存在 ~/.hermes/,注意备份即是你自己掌控。
Hermes Agent 的安装脚本与版本会随官方仓库更新,部署前在 GitHub 仓库或官方文档确认当期步骤即可。想持续跟进 Hermes Agent 安装与自托管玩法的最新动态,可以关注本站的 AI 工具栏目,有新版本我们会同步更新。