Hermes Agent 入门指南:安装并运行你的第一个自进化 AI 智能体
Hermes Agent 入门指南:安装并运行你的第一个自进化 AI 智能体
"它不是聊天机器人,不是代码补全工具。它是一个住在你的服务器上、越用越聪明的 AI 智能体。"
Hermes Agent 是什么?
Hermes Agent 是由 Nous Research 开发的开源、自进化的 AI 智能体框架,采用 MIT 许可证,于 2026 年 2 月发布。Nous Research 是业界最有影响力的开源 AI 研究机构之一,此前推出了多款重量级开源模型。
它和其他 AI 工具有什么不同?
| 特性 | 说明 |
|---|---|
| 持久记忆 | 跨会话记住你的偏好、项目和上下文。不用每次都重新解释你是谁。 |
| 自动技能创建 | 当 Hermes 解决一个复杂问题后,它会自动写下可复用的技能文档,永远不忘。 |
| 多平台接入 | 一个智能体,同时接入 Telegram、Discord、Slack、WhatsApp、Signal 和 CLI。 |
| 完全自托管 | 运行在你自己的服务器上。所有数据存储在 ~/.hermes/,无遥测、无追踪、无云端锁定。 |
| 任意模型 | 一行命令切换 300+ 模型——Nous Portal、OpenAI、Anthropic、Google、xAI、本地 vLLM…… |
| 40+ 内置技能 | 代码执行、网页搜索、浏览器自动化、图片生成、GitHub 操作——开箱即用。 |
截至 2026 年 7 月,Hermes Agent 拥有超过 17,000 个 GitHub Star 和 207+ 贡献者。
这份指南适合谁?
- 开发者 — 想要一个属于自己的 AI 智能体,跑在自己的基础设施上
- AI 爱好者 — 对开源 Agent 框架充满好奇
- MLOps 工程师 — 寻找生产级的 Agent 框架
- 任何人 — 厌倦了每次对话都失忆的聊天机器人
你不需要深入了解 AI。但你需要在终端里执行命令的基本能力。
安装前准备
硬件要求
- 任何 Linux、macOS 或 Windows 机器(Windows 原生支持,不需要 WSL)
- 一台 $5 的 VPS 就能跑。GPU 集群也行。Hermes 可以按你有的资源扩展。
- 存储空间: 约 2GB(代码 + 依赖 + 模型缓存)
- 内存: 最低 2GB,建议 8GB+(如果要跑本地模型)
前置软件
安装程序几乎会自动处理所有依赖:
| 要求 | 说明 |
|---|---|
| Git | 必须已安装(git --version 检查) |
| curl + xz-utils | (Linux 需要)用于下载 Node.js |
| build-essential | (Linux,桌面版需要)sudo apt install build-essential |
| 其他所有 | Python 3.11、Node.js v22、ripgrep、ffmpeg——全部自动安装 |
标准安装不需要 sudo。 安装程序会自动检测缺少什么并帮你装上。
第一步:安装 Hermes Agent
一行命令(Linux / macOS / WSL2)
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
就这一行。安装程序会自动:
- 下载并安装
uv(快速 Python 包管理器) - 安装 Python 3.11(通过 uv,不影响系统 Python)
- 克隆 Hermes Agent 仓库
- 创建虚拟环境并安装所有依赖
- 创建
hermes命令(软链接到~/.local/bin/hermes) - 如有需要,自动安装 Node.js v22、ripgrep、ffmpeg
安装完成后,重新加载终端:
source ~/.bashrc # 或 source ~/.zshrc
Windows(原生 PowerShell)
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
Windows 原生完全支持——CLI、网关、TUI 和所有工具都能原生运行,不需要 WSL。
Android(Termux)
如果你想在手机上安装,请参考专门的 Termux 指南。
桌面版安装(macOS / Windows)
如果你想要图形化的安装体验(CLI + 桌面应用),从 hermes-agent.nousresearch.com 下载安装包。
第二步:选择 AI 提供商
这是最重要的一步。运行:
hermes model
这会启动交互式设置向导。以下是你最好的选择:
🚀 最快路径:Nous Portal(推荐新手)
hermes setup --portal
这一条命令就完成了 OAuth 登录、设置 Nous Portal 为提供商、启用 Tool Gateway(网页搜索、图片生成、TTS、云端浏览器)——零 API Key 管理。
Nous Portal 一个订阅就能用 300+ 模型。不需要在多个提供商之间切换 API Key。
其他常见选择
| 提供商 | 设置方式 | 适合 |
|---|---|---|
| OpenAI Codex | hermes model → OAuth 登录 |
ChatGPT 订阅用户 |
| Anthropic | hermes model → OAuth(需要 Max 套餐) |
Claude 用户 |
| OpenRouter | 输入 API Key | 需要多提供商灵活切换 |
| 本地 vLLM | 自定义端点 | 注重隐私/控制成本 |
| GitHub Copilot | OAuth 登录 | Copilot 订阅用户 |
| xAI Grok | OAuth(SuperGrok 套餐) | Grok 用户 |
| DeepSeek | 设置 DEEPSEEK_API_KEY | 性价比优先 |
小贴士: 新手先用 Nous Portal,体验最流畅。以后可以用 hermes model 随时切换提供商。
第三步:验证是否工作
选好提供商后,开始你的第一次对话:
hermes
这会启动 Hermes 的 TUI(终端用户界面)——一个完整的交互式环境,具备:
- 多行编辑(写复杂提示时可以换行)
- 斜杠命令自动补全(输入
/查看可用命令) - 对话历史(滚动浏览之前的对话)
- 流式工具输出(实时看到智能体在思考什么)
试试这些提示:
你有哪些技能可以用?
帮我搜索一下今天最新的 AI 新闻。
写一个 Python 脚本,抓取今天 Hacker News 的头条。
如果 Hermes 回复了,恭喜——你已经成功运行了自己的 AI 智能体!
退出 TUI
按 Ctrl+C 或 Ctrl+D 退出对话。
第四步:常用命令一览
| 命令 | 功能 |
|---|---|
hermes |
启动 TUI 对话 |
hermes model |
切换 AI 提供商/模型 |
hermes tools |
启用/禁用工具(网页、浏览器、代码执行等) |
hermes setup |
运行完整设置向导 |
hermes update |
拉取最新代码并重新安装依赖 |
hermes config set <键> <值> |
设置单个配置项 |
hermes gateway setup |
配置消息平台(Telegram、Discord 等) |
hermes skills |
列出已安装的技能 |
hermes --help |
显示所有可用命令 |
了解你的智能体家园
Hermes 知道的一切都存放在 ~/.hermes/:
~/.hermes/
├── hermes-agent/ # 克隆的仓库
├── config.yaml # 你的设置(提供商、工具等)
├── sessions/ # 对话历史
├── memory/ # 长期记忆存储
├── skills/ # 自动创建和安装的技能
└── data/ # 智能体本地数据文件
隐私说明: 所有数据都存放在你机器的这个目录中。无遥测、无回传、无云端依赖。一切你说了算。
你现在能做什么?
有了一个正常运行的 Hermes Agent,你马上可以:
✅ 进行跨会话的持续对话——它记得之前说过什么 ✅ 搜索网页和浏览页面内容 ✅ 执行 Python 和 Shell 命令(带安全沙箱) ✅ 做代码分析和调试 ✅ 访问文件系统(需要授权) ✅ 生成图片(如果你的提供商支持)
常见问题
安装后找不到 "hermes" 命令
source ~/.bashrc # 或 source ~/.zshrc
Linux 安装失败
确保安装好了前置工具:
sudo apt install curl xz-utils git
模型不回复
- 检查提供商配置:
hermes model - 确认账户有足够额度/配额
- 试试 Nous Portal 零配置方案:
hermes setup --portal
TUI 卡住了
- 等待智能体思考完成(它会流式输出)
- 按
Ctrl+C中断并返回提示符 - 确保终端支持 UTF-8 和真彩色
下一篇预告
这是 Hermes Agent 系列教程的第一阶段。你已经安装了智能体、完成了第一次对话、学会了 CLI 基础。预告一下接下来的内容:
| 阶段 | 标题 | 覆盖内容 |
|---|---|---|
| 🟢 第一阶 | 入门指南 ← 你在这里 | 安装、配置、第一次对话、CLI 基础 |
| 🟡 第二阶 | 让 Hermes 记住你 | 记忆系统、技能创建、多平台网关(Telegram/Discord/Slack) |
| 🟠 第三阶 | 高级玩法 | 自定义模型、自动化(cron 任务)、并行子智能体、自定义工具 |
| 🔴 第四阶 | 骨灰级大师 | 强化学习训练、轨迹生成、微调自己的 Agent 模型 |
第一阶段的小任务: 让 Hermes 跑起来,至少和它对话三次,然后试试让它创建一个技能。看看一个会学习的智能体在你的工作流中能产生什么化学反应。
相关资源
- 官方网站: hermes-agent.nousresearch.com
- GitHub: github.com/NousResearch/hermes-agent
- 文档: hermes-agent.nousresearch.com/docs
- Discord: Nous Research Discord
- 视频教程: Hermes Agent 教程播放列表 (YouTube)
觉得这份指南有用?分享给对运行自己 AI 智能体感兴趣的朋友吧。
更新说明:本文指南基于 2026 年 7 月 9 日的 Hermes Agent 最新稳定版本。