系统要求#

什么是 Git？ Git 是一个代码管理工具，几乎所有开发者电脑上都有。如果你电脑上没有，安装脚本会告诉你怎么装。

方式一：桌面应用安装（最简单）#

这是最适合小白的方式，有图形界面，点点鼠标就能完成。

第一步：下载安装包

1. 打开浏览器，访问 https://hermes-agent.nousresearch.com
2. 找到 “Download” 按钮，点击下载 Windows 版本
3. 等待下载完成

第二步：安装

1. 打开下载文件夹，找到刚下载的安装包（.exe 文件）
2. 双击运行安装包
3. 如果弹出 Windows 安全提示 “Windows 已保护你的电脑”：
   • 点击 “更多信息”
   • 然后点击 “仍要运行”
4. 按照安装向导点 “下一步” → “安装” → “完成”

第三步：首次启动

1. 安装完成后，桌面会出现 Hermes 图标，双击打开
2. 或者在开始菜单搜索 “Hermes” 打开
3. 应用会自动引导你完成初始设置

桌面应用安装后，终端也可以直接使用 hermes 命令。

方式二：PowerShell 命令安装#

如果你更喜欢用命令行，或者桌面应用安装失败，可以用这种方式。

第一步：打开 PowerShell

1. 按键盘上的 Win 键（就是有 Windows 图标的那个键，在键盘左下角）
2. 输入 “powershell”
3. 在搜索结果中找到 “Windows PowerShell”
4. 右键 → 选择 “以管理员身份运行”
5. 如果弹出 “是否允许此应用对你的设备进行更改？“，点 “是”

什么是 PowerShell？ PowerShell 是 Windows 自带的命令行工具，类似于一个文字版的”控制台”。你在里面输入命令，电脑就会执行操作。

第二步：运行安装命令

复制下面这一整行命令：

1
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

然后在 PowerShell 窗口里 右键 粘贴，按 回车键 执行。

怎么粘贴？ 复制命令后，在 PowerShell 窗口里直接 右键 就能粘贴（不是 Ctrl+V）。

第三步：等待安装完成

安装脚本会自动做以下事情（你不需要操作，耐心等着就行）：

1. ✅ 检测你的电脑系统
2. ✅ 安装 Python 3.11（通过 uv，不需要你手动装）
3. ✅ 安装 Node.js v22（不需要你手动装）
4. ✅ 安装 ripgrep（快速搜索工具）
5. ✅ 安装 ffmpeg（音频处理工具）
6. ✅ 克隆 Hermes 代码仓库
7. ✅ 创建虚拟环境并安装依赖
8. ✅ 配置全局 hermes 命令

整个过程大概 3-8 分钟，取决于你的网速。

第四步：重新打开 PowerShell

安装完成后，关闭当前的 PowerShell 窗口，重新以管理员身份打开一个新的 PowerShell。

为什么要重新打开？ 因为安装脚本修改了系统的 PATH 环境变量，需要重新打开才能生效。

第五步：跟着设置向导走

安装完成后会自动启动设置向导，它会问你几个问题：

1. 选择 AI 模型提供商 — 比如 OpenAI（ChatGPT）、Anthropic（Claude）、DeepSeek 等
2. 输入 API 密钥 — 去对应平台的网站申请一个 API Key 填进去

什么是 API Key？ API Key 就像一个”通行证”，让 Hermes 能调用 AI 模型。去对应平台（比如 OpenAI）注册账号，在 API Keys 页面创建一个就行。大部分平台新用户有免费额度。

第六步：验证安装

在新的 PowerShell 窗口中输入：

1
hermes --version

如果显示版本号（比如 Hermes Agent v0.x.x），说明安装成功了！

再输入：

1
hermes doctor

这会检查你的安装是否完整。如果有问题，它会告诉你怎么修。

第七步：开始使用

1
hermes

输入这条命令就能开始跟 AI 对话了！

Windows 常见问题#

Q: 安装时提示”无法加载脚本”或”执行策略”错误？

在 PowerShell 中先执行这条命令，然后再安装：

1
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force

Q: hermes 命令找不到？

1
# 检查 PATH
2
echo $env:PATH -split ";" | Select-String "hermes"
3

4
# 如果没有，手动添加
5
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:LOCALAPPDATA\hermes\hermes-agent\venv\Scripts", "User")

然后重新打开 PowerShell。

Q: 安装时网络超时？

可能是网络问题，试试国内镜像或重新运行安装命令。

Q: Windows Terminal 里 Alt+Enter 不能换行？

这是 Windows Terminal 的限制，用 Ctrl+Enter 代替。

方式一：桌面应用安装（最简单）#

第一步：下载安装包

1. 打开浏览器，访问 https://hermes-agent.nousresearch.com
2. 找到 “Download” 按钮，点击下载 macOS 版本（.dmg 文件）
3. 等待下载完成

第二步：安装

1. 打开下载文件夹，找到刚下载的 .dmg 文件
2. 双击打开它
3. 会出现一个窗口，里面有一个 Hermes 图标
4. 把 Hermes 图标拖到 Applications 文件夹（就像装其他 Mac 应用一样）
5. 等待复制完成

第三步：首次打开

1. 打开 Finder → 应用程序（Applications）
2. 找到 Hermes，双击打开
3. 第一次可能会弹出提示 “Hermes 是从互联网下载的应用”，点 “打开”
4. 应用会自动引导你完成初始设置

桌面应用安装后，终端也可以直接使用 hermes 命令。

方式二：终端命令安装#

第一步：打开终端

1. 按 Command + 空格键（同时按这两个键）
2. 会弹出 Spotlight 搜索框
3. 输入 “终端” 或 “Terminal”
4. 按 回车键 打开终端

什么是终端？ 终端是 Mac 的命令行工具。你在里面输入文字命令，电脑就会执行操作。看起来有点像电影里的黑客界面，但其实用起来很简单。

第二步：运行安装命令

复制下面这一整行命令：

1
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

在终端里粘贴（快捷键 Command + V），按 回车键 执行。

第三步：输入密码

安装过程中可能会要求输入你的 Mac 开机密码（就是你登录 Mac 时用的密码）。

为什么输密码看不见任何字符？ 这是正常的！Mac 终端输入密码时不会显示任何东西（连星号 *** 都没有）。你就直接输入密码，然后按回车就行。不用担心，密码确实在输入。

第四步：等待安装完成

安装脚本会自动做以下事情：

1. ✅ 安装 Homebrew（Mac 的软件管理器，如果还没有的话）
2. ✅ 安装 Python 3.11（通过 uv）
3. ✅ 安装 Node.js v22
4. ✅ 安装 ripgrep、ffmpeg
5. ✅ 克隆 Hermes 代码仓库
6. ✅ 创建虚拟环境并安装依赖
7. ✅ 配置全局 hermes 命令

整个过程大概 3-10 分钟，取决于你的网速和电脑速度。

Apple Silicon（M1/M2/M3/M4 芯片）用户注意： 安装脚本会自动检测你的芯片类型，安装对应版本。不需要额外操作，放心等着就行。

第五步：重新加载终端配置

安装完成后，在终端输入：

1
source ~/.zshrc

macOS 默认使用 zsh 作为终端 shell，这行命令是让终端”刷新”一下，识别新安装的 hermes 命令。

如果提示找不到文件，试试：

1
source ~/.bash_profile

第六步：跟着设置向导走

安装完成后会自动启动设置向导：

1. 选择 AI 模型提供商 — 比如 OpenAI（ChatGPT）、Anthropic（Claude）、DeepSeek 等
2. 输入 API 密钥 — 去对应平台的网站申请一个 API Key 填进去

没有 API Key 怎么办？ 推荐先用 Nous Portal（最快方式）：

1
hermes setup --portal

一条命令搞定登录、选模型、开启工具。

第七步：验证安装

1
hermes --version
2
hermes doctor

如果显示版本号，安装成功！

第八步：开始使用

1
hermes

开始跟 AI 对话！

macOS 常见问题#

Q: 提示 “command not found: hermes”？

1
# 重新加载配置
2
source ~/.zshrc
3

4
# 如果还不行，检查 PATH
5
echo $PATH | tr ':' '\n' | grep hermes
6

7
# 手动添加 PATH
8
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
9
source ~/.zshrc

Q: 安装 Homebrew 时卡住？

Homebrew 安装可能需要较长时间（尤其是第一次）。耐心等待。如果超过 10 分钟没反应，按 Ctrl + C 取消，重新执行。

Q: 提示 “xcrun: error: invalid active developer path”？

安装 Xcode 命令行工具：

1
xcode-select --install

按提示点”安装”，等完再重新运行 Hermes 安装命令。

Q: 安装过程中提示 “Permission denied”？

1
# 修复权限
2
sudo chown -R $(whoami) ~/.hermes

输入开机密码（不显示字符，正常），然后重新安装。

Ubuntu / Debian#

第一步：安装依赖

打开终端，输入：

1
sudo apt update
2
sudo apt install -y git curl xz-utils

什么是 sudo？ sudo 是”以管理员身份运行”的意思。会要求你输入密码（Linux 的登录密码），输入时不显示字符，正常。

第二步：一键安装

1
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

第三步：验证

1
source ~/.bashrc
2
hermes --version
3
hermes doctor

CentOS / Fedora / RHEL#

1
# Fedora / RHEL 9+
2
sudo dnf install -y git curl xz
3

4
# CentOS 7/8
5
sudo yum install -y git curl xz
6

7
# 安装 Hermes
8
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Arch Linux#

1
sudo pacman -S git curl xz base-devel
2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

openSUSE#

1
sudo zypper install -y git curl xz
2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash