🪽Hermes Agent 安装教程

📖 这个教程怎么用？

这是一份手把手教程。你不需要懂任何编程知识，只要会打开网页、会打字就够了。

教程里会出现一些"代码"和"终端画面"——不要被它们吓到，你只需要照着图片里的内容，一步一步做。

0认识 Hermes Agent

Hermes Agent（赫尔墨斯智能体）是一个免费的"电脑助手"程序，由美国 Nous Research 公司开发。

它长得像一个终端聊天窗口——你把问题打进去，它帮你做事。但它不只是聊天：你让它"整理桌面文件"，它真的会去移动文件。你让它"写一篇 Word 文档"，它真的会写。

Mac 用户特别友好

macOS 是运行 Hermes 最丝滑的平台。你的 Mac 自带所有必要工具（Git），安装脚本会自动搞定其余一切。

1准备网络环境（科学上网）

什么是"梯子" / "科学上网"？

简单说就是一个软件，让你的电脑能正常访问国外的网站（比如 GitHub、Google）。国内因为网络限制，这些网站直接打不开，需要借助一个"中转站"。这类服务通常被称为机场。

推荐方案：ikuuu

如果你还没有梯子，这个方案经过验证，便宜好用：

具体操作（三步搞定）

2认识你的 Mac：如何打开「终端」

什么是"终端"（Terminal）？

终端是 Mac 自带的一个程序。它看起来像一个黑底白字的文本框——你可以在里面输入命令，让电脑执行各种操作。

可以把它理解为"用打字的方式控制电脑"。平时你用鼠标点点点能做的事，终端里输入一行文字也能做，而且往往更快。

安装 Hermes 只需要用到终端一次（粘贴一条命令），之后就完全不需要再碰终端了。

三种打开方式（任选一种）

打开后你看到什么？

终端打开后，你会看到一个类似这样的窗口：

💻 终端

Last login: Mon Jun  8 14:30:00 on ttys000
你的名字@你的Mac ~ % ← 光标在这里一闪一闪，等你输入

那一闪一闪的小竖线叫做光标，说明终端在等你打字。后面我们会在这里粘贴安装命令。

3安装前检查：确认 Git 已就绪

Git 是什么？

Git 是一个"代码下载工具"。Hermes 的安装脚本需要用 Git 从网上下载程序文件。好消息：每台 Mac 出厂就自带 Git，你不需要装任何东西。

怎么确认 Git 能用？

在终端里输入下面这行，然后按回车：

💻 终端 — 你只需要输入这行

$ git --version
# 在你的终端里输入：git --version（中间有两个减号）然后按回车

你会看到类似这样的输出——这说明 Git 准备好了：

💻 正常输出

git version 2.39.3 (Apple Git-146)
# ✅ 看到版本号 = Git 已就绪，可以进入下一步

$ xcode-select --install

4正式安装：在终端里执行一条命令

这是整个安装过程最关键的一步，也是最简单的一步——你只需要做一件事：

接下来会发生什么？

按回车后，屏幕上会开始出现很多文字在滚动。这是正常的——安装脚本正在自动下载和安装所有需要的组件。整个过程约 2~5 分钟，你不需要做任何操作，看着就行。

安装脚本做了什么？（可跳过不看）

安装成功后，你会看到类似这样的画面：

💻 安装成功画面

→ Cloning NousResearch/hermes-agent (main)...
✓ Repository cloned
→ Creating virtual environment...
→ Installing Python dependencies...
✓ Dependencies installed

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  🎉 Hermes Agent installed!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

→ Run source ~/.zshrc to reload your shell
→ Then run hermes to start!

看到 🎉 Hermes Agent installed! 就说明装好了！

5安装完成后的操作

5.1 关闭终端，重新打开（或者输入一行命令）

安装完成后，电脑还不知道你新装了一个叫 hermes 的命令。需要"刷新"一下。有两种方法：

5.2 了解一下文件装在了哪里（可选）

安装后，你电脑上多了这些文件夹——你平时不需要打开它们，知道有就行了：

💡 ~（波浪号）在 Mac 上代表你的"个人文件夹"，即 /Users/你的用户名/。所以 ~/.hermes/ 实际位置就是 /Users/你的用户名/.hermes/。

6验证安装是否成功

打开终端（如果关掉了就重新打开），输入下面两行验证（每行输完后按回车）：

💻 终端 — 第 1 条命令

$ hermes --version
Hermes Agent v0.16.0 · macOS (arm64)
# ✅ 看到版本号 = 安装成功！

💻 终端 — 第 2 条命令（可选）

$ hermes doctor
🔍 Hermes Doctor

System:   macos-arm64
Python:   3.11.9
Shell:    /bin/zsh
Config:   ~/.hermes/config.yaml ✓
Env:      ~/.hermes/.env ✓

Dependencies:
  python3.11 ✓   git ✓   node v22 ✓   ripgrep ✓   ffmpeg ✓

✓ All checks passed!
# doctor = 体检，看看有没有哪里不对劲

7配置 AI 提供商（让它"变聪明"）

Hermes 装好了，但它还需要连接一个 "AI 大脑" 才能聊天和干活。这一步就是给它选一个 AI 服务商。

你需要准备什么？

大多数提供商需要你有一个 API Key（一串密码）。去对应提供商的网站上注册账号就能拿到，通常 1~2 分钟搞定。有些提供商（如 DeepSeek）充值 ¥10 就能用很久。

推荐起步方案

具体操作（以 DeepSeek 为例）

💻 终端 — 设置 API Key

# 把 sk-xxxxx 替换成你自己的 Key
$ hermes config set model.provider deepseek
$ hermes config set model.default deepseek/deepseek-chat
$ hermes config set model.api_key sk-xxxxxxxxxxxxxxxx

# 或者使用交互式菜单（更简单，推荐）：
$ hermes model
# ↑ 这个命令会打开一个菜单，用 ↑↓ 方向键选择 DeepSeek，按提示输入 Key 即可

8第一次对话

配置好提供商后，在终端输入 hermes 然后回车，你就进入了 Hermes 的聊天界面：

💻 终端 — 首次对话

$ hermes

╔══════════════════════════════════════╗
║       🕊️  Hermes Agent               ║
║       Nous Research                  ║
╚══════════════════════════════════════╝

Model:    deepseek/deepseek-chat
Provider: deepseek
──────────────────────────────────────

> 你好！帮我写一个 Python 的 Hello World 程序

你好！我来帮你创建一个简单的 Python 程序。

我先创建文件 hello.py：
✓ Created hello.py

然后运行它：
✓ Hello, World!

✅ 完成！hello.py 已经保存在你的当前目录里了。

怎么退出？

在聊天界面中，输入 /quit 或 /exit 然后回车，就能退出来。

三个最实用的内置命令

9常见问题 + 下一步做什么

常见问题

接下来可以玩什么？

1. 多聊天：让 Hermes 帮你写文档、整理文件、搜资料。每次任务都是一次练习。
2. 安装技能：终端输入 hermes skills browse，浏览别人写好的技能模板，一键安装。
3. 连到手机上：如果你想让 Hermes 在 Telegram 或微信上回复你，输入 hermes gateway setup。