hermes教程-安装

快速安装

在 macOS 或 Windows 上使用 Hermes Desktop 安装程序（推荐）

要轻松安装命令行和桌面应用程序，请从我们的网站下载 Hermes Desktop 安装程序并运行它。

不使用 Hermes Desktop：

如需仅安装命令行而不安装 Hermes Desktop，请运行：

Linux / macOS / WSL2 / Android (Termux)

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

Windows (原生)

在 PowerShell 中运行：

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

如果在仅安装命令行后想要安装并运行 Hermes Desktop，只需运行：

hermes desktop

安装程序的作用

安装程序会自动处理所有事情——所有依赖项（Python、Node.js、ripgrep、ffmpeg）、仓库克隆、虚拟环境、全局 hermes 命令设置以及 LLM 提供商配置。完成后，您就可以开始聊天了。

安装布局

安装程序放置文件的位置取决于您是以普通用户还是 root 身份安装：

root 模式的 FHS 布局 (/usr/local/lib/…, /usr/local/bin/hermes) 与 Linux 上其他系统级开发者工具的位置一致。这对于共享机器部署非常有用，一个系统安装即可服务于所有用户。每用户配置（认证、技能、会话）仍然位于每个用户的 ~/.hermes/ 或显式指定的 HERMES_HOME 下。

安装后

重新加载 shell 并开始聊天：

source ~/.bashrc   # 或：source ~/.zshrc
hermes             # 开始聊天！

稍后要重新配置单个设置，请使用专用命令：

hermes model          # 选择您的 LLM 提供商和模型
hermes tools          # 配置哪些工具已启用
hermes gateway setup  # 设置消息平台
hermes config set     # 设置单个配置值
hermes setup          # 或运行完整设置向导以一次性配置所有内容

提示 — 最快路径：Nous Portal

一个订阅即可覆盖 300 多个模型以及 Tool Gateway（网页搜索、图像生成、TTS、云浏览器）。无需为每个工具管理密钥：

bashCopy

hermes setup --portal

该命令将登录、将 Nous 设置为提供商，并一键启用 Tool Gateway。

前提条件

安装程序： 在非 Windows 平台上，唯一的前提条件是 Git。安装程序会自动处理其他所有事情：

• uv（快速 Python 包管理器）
• Python 3.11（通过 uv，无需 sudo）
• Node.js v22（用于浏览器自动化和 WhatsApp 桥接）
• ripgrep（快速文件搜索）
• ffmpeg（用于 TTS 的音频格式转换）

信息

您无需手动安装 Python、Node.js、ripgrep 或 ffmpeg。安装程序会检测缺少的内容并为您安装。只需确保 git 可用即可（git --version）。

提示 — Nix 用户

如果您使用 Nix（在 NixOS、macOS 或 Linux 上），有一个专用的设置路径，包含 Nix flake、声明式 NixOS 模块和可选的容器模式。请参阅 Nix 和 NixOS 设置 指南。

手动 / 开发者安装

如果您想克隆仓库并从源代码安装——用于贡献、从特定分支运行或完全控制虚拟环境——请参阅贡献指南中的开发设置部分。

非 sudo / 系统服务用户安装

支持将 Hermes 作为专用的非特权用户运行（例如 hermes systemd 服务账户，或任何没有 sudo 访问权限的用户）。安装路径中唯一真正需要 root 权限的是 Playwright 的 --with-deps 步骤，该步骤通过 apt 安装 Chromium 使用的共享库（libnss3、libxkbcommon 等）。安装程序会检测 sudo 是否可用，并在不可用时优雅地降级——它会将 Chromium 二进制文件安装到服务用户自己的 Playwright 缓存中，并打印管理员需要单独运行的确切命令。

推荐的分步操作（Debian/Ubuntu）：

1. 一次性操作，以具有 sudo 权限的管理员身份，安装 Chromium 所需的系统库：

   bashCopy

   sudo npx playwright install-deps chromium

   （您可以从任何位置运行此命令——npx 会即时获取 Playwright。）

2. 以非特权服务用户身份，运行常规安装程序。它会检测到缺少 sudo，跳过 --with-deps，并将 Chromium 安装到用户的本地 Playwright 缓存中：

   bashCopy

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

   如果您想完全跳过 Playwright 步骤——例如，因为您正在运行无头模式且不需要浏览器自动化——请传递 --skip-browser：

   bashCopy

   curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browser

3. 使 hermes 对服务用户的 shell 可用。 安装程序将启动器写入 ~/.local/bin/hermes。系统服务账户通常具有最小的 PATH，不包含 ~/.local/bin。要么将其添加到用户的环境中，要么将启动器符号链接到系统位置：

   bashCopy

   undefined

选项 A — 添加到服务用户的配置文件

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

选项 B — 系统范围符号链接（以管理员身份运行）

sudo ln -s /home/hermes/.hermes/hermes-agent/venv/bin/hermes /usr/local/bin/hermes

4. **验证：** `hermes doctor` 现在应该可以正常运行。如果出现 `ModuleNotFoundError: No module named 'dotenv'`，说明您正在使用系统 Python 调用仓库源 `hermes` 文件（`~/.hermes/hermes-agent/hermes`），而不是 venv 启动器（`~/.hermes/hermes-agent/venv/bin/hermes`）——请修复步骤 3。

相同的模式适用于 Arch（安装程序使用 pacman，并采用相同的 sudo 检测逻辑）、Fedora/RHEL 和 openSUSE——这些发行版根本不支持 `--with-deps`，因此管理员需要单独安装系统库。相关的 `dnf`/`zypper` 命令会由安装程序打印出来。

---

## 故障排除

| 问题 | 解决方案 |
|------|----------|
| `hermes: command not found` | 重新加载 shell（`source ~/.bashrc`）或检查 PATH |
| `API key not set` | 运行 `hermes model` 配置您的提供商，或运行 `hermes config set OPENROUTER_API_KEY your_key` |
| 更新后缺少配置 | 运行 `hermes config check`，然后运行 `hermes config migrate` |

如需更多诊断，请运行 `hermes doctor`——它会准确告诉您缺少什么以及如何修复。

## 安装方法自动检测

Hermes 会自动检测它是通过 `pip`、git 安装程序、Homebrew 还是 NixOS 安装的，并且 `hermes update` 会打印该路径对应的更新命令。无需设置环境变量——检测基于安装布局（Python site-packages、`~/.hermes/hermes-agent/`、Homebrew 前缀或 Nix store 路径）。`hermes doctor` 也会在其环境摘要中显示检测到的方法。

---

---