把 Hermes 装回家——安装其实很简单

上一期我们聊了 Hermes 能干什么，这一期直接上手——装就完事了。别担心，整个过程比你周末装个游戏还快，官方说两分钟以内，咱实测差不多。

最省事的路：桌面安装包（macOS / Windows）

如果你用的是 Mac 或 Windows，直接去官网下载对应平台的安装包，双击运行，命令行和桌面应用一次性搞定。装完就能开聊，啥都不用管。

Windows：用 Windows App Installer 打开下载的 .appinstaller，它会装上签名的 MSIX 包并记录更新来源。注意 Microsoft Store 版本是另一套归属，别混着用。
macOS：打开 DMG，把 Hermes.app 拖进 Applications 就行。ZIP 包里那份是自动更新器用的签名版应用。

打包好的安装包内含 agent、Python、依赖和预构建界面，首次启动不需要再现场编译运行时。不过访问提供商和可选集成仍然可能需要联网。

另外提一句：Hermes-Setup 那种引导安装器是另一回事——它会下载源码再编译桌面应用。详见 Hermes Desktop。

还有一点：没有单独的“纯远程”桌面版下载。如果你想用桌面端连另一台机器上的 Hermes 后端，就装上面这些常规安装包，然后在 Settings → Gateways 里连过去；具体见连接远程后端。

Mac 用户注意：macOS 安装包只支持 Apple Silicon（M 系列芯片）。Intel 处理器的 Mac 不在支持范围内，别白折腾。

纯命令行安装（Linux / macOS / WSL2）

不想装桌面端？一条命令的事（Android / Termux 走下面的 APT 包，不是这套脚本）：

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

Windows 原生用户，在 PowerShell 里跑：

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

装完如果后悔了想补个桌面端，再敲一句 hermes desktop 就行。

Android / Termux

Android 用户走 Termux APT 包：在 aarch64 设备上先配好签名仓库，再 pkg install hermes-agent。桌面/服务器那套脚本不是 Termux 的安装路径。

安装器到底帮你干了啥？

啥都帮你干了。 脚本会克隆源码、引导 uv，然后把依赖准备交给 PM——PM 提供固定版本的 Python、Node.js、npm、ripgrep 和 FFmpeg。源码安装选的是 all 这个 Python extra，不是所有可选 extra。其他可选工具走各自功能专属的安装路径。

关于 uv：脚本永远下载它自己验证过的固定版本 uv，不会用你 PATH 里已经装好的那个。所以别担心版本冲突，也别指望省这一步。

PM 默认还会装浏览器和电脑操作工具：一个固定版本的 Chromium（Chrome for Testing，Hermes 本地浏览时启动它）和 cua-driver（电脑操作驱动，支持 macOS、Windows 和 glibc Linux）。这一步下载失败也不影响安装完成，脚本会打印重试命令。browser_exec 背后的浏览器驱动 browser-harness（Browser Use CLI 的引擎）就是个普通的 Python 依赖，所以每次安装——包括桌面应用——都已经自带它了。在 PM 没有 Chromium 构建的平台上（Android/Termux、musl Linux），Hermes 会改用 PATH 里的系统 chromium。

不想装这些？POSIX 上加 --skip-browser，Windows 上用 -SkipBrowser；电脑操作驱动对应 --skip-computer-use / -SkipComputerUse。Hermes 会记住这个选择：之后的安装和 hermes update 都不会再把它加回来。想反悔就 hermes pm install chromium 或 hermes pm install cua-driver。

新安装会落在最新稳定版上，之后 hermes update 也跟随这个通道（见更新）。想装 main 分支的最新提交，POSIX 上加 --channel main，Windows 上用 -Channel main（或先设 HERMES_INSTALL_CHANNEL=main，适用于一行命令）。

脚本还会建启动器、准备数据目录。交互式运行会顺带跑 setup 和 gateway 配置；--non-interactive（POSIX）或 -NonInteractive（Windows）跳过需要输入的阶段。可选的 --include-desktop / -IncludeDesktop 会从源码构建桌面端。

在终端里跑的话，脚本每一步只显示一行状态，git、uv 和构建的输出都写进 Hermes 数据目录下的 logs/install.log；某一步失败会打印最后几行和日志路径。CI 环境（设了 CI 或 GITHUB_ACTIONS）、重定向输出、--verbose / -Verbose 或 HERMES_INSTALL_VERBOSE=1 则会全程流式输出。

小提示：POSIX 源码脚本需要 Git、curl、tar 和 SHA-256 工具。Windows 在缺 Git 时能自动引导固定版本的 Git for Windows。想装桌面端的话，源码构建可能还需要原生编译器和平台开发库。

装完放哪儿了？

普通用户装的话，代码在 ~/.hermes/hermes-agent/，hermes 命令软链到 ~/.local/bin/hermes，数据在 ~/.hermes/。Windows 源码脚本则把代码放在 %LOCALAPPDATA%\hermes\hermes-agent\，命令入口在 %LOCALAPPDATA%\hermes\bin\，数据在 %LOCALAPPDATA%\hermes\。桌面安装包则把代码放在应用包内部，用打包好的启动器（Windows 上是执行别名），数据落在平台默认的 Hermes 数据目录。多用户共享一台机器时，系统级安装更合适，但每个用户的配置和会话还是各放各的 ~/.hermes/。HERMES_HOME 可以指定用户数据位置。

装完第一件事

刷新一下 shell，开聊：

source ~/.bashrc   # 或者 source ~/.zshrc
hermes

想调设置？不用翻配置文件，专用命令随你使：

hermes model          # 选 LLM 提供商和模型
hermes tools          # 配置启用哪些工具
hermes gateway setup  # 接入消息平台
hermes config set     # 改单个配置项
hermes config get     # 查看单个配置项
hermes setup          # 或者跑完整设置向导

最速传说：Nous Portal

不想一个个配 API key？hermes setup --portal 一条命令搞定：登录、设 Nous 为提供商、开启 Tool Gateway（网页搜索、图片生成、TTS、云浏览器），一个订阅覆盖 300+ 模型，省心到飞起。

换机器了咋办？

不用从头配。hermes import 能恢复完整备份，hermes profile import 可以只搬单个 agent。注意：profile 导出默认不含凭证，所以完整迁移记得用 hermes backup。

还有啥要注意的？

Nix 用户：Nix 不再是官方明确支持的安装路径了（只能尽力而为）。不过如果你已经在用 Nix，有专门的 flake 和 NixOS 模块可以走，详见 Nix 设置指南。
无 sudo 用户：想用普通用户跑 Hermes 完全没问题。系统库归管理员管，PM 只管工具二进制——所以服务账号没 sudo 时，安装器会直接把需要管理员执行的 libatomic 命令打印给你，照着转给管理员就行。
glibc Linux 的 libatomic：PM 管理的 Node.js 会链接 libatomic.so.1，而精简版 Debian、Ubuntu 和 RHEL 系镜像默认不带这个库。缺库时，安装器和 hermes update 会自动装对应发行版的包（apt 和 zypper 上是 libatomic1，dnf/yum 和 apk 上是 libatomic，pacman 上是 gcc-libs）。有 root 就直接跑包管理器，否则用 sudo -n；交互式运行会在装依赖前问一次 sudo 密码，--non-interactive 则从不询问。实在装不了，报错里会写清楚它找到的包管理器该跑哪条命令。
系统库不归安装器管：当前源码安装器不会跑 Playwright 的 --with-deps 那一步，除了上面说的 Node.js libatomic，它不装任何系统包。工具二进制 PM 管，系统库得管理员提供。
软链接家目录 / 外置存储：Hermes 支持把 HERMES_HOME 以及 hooks、skills、sessions、logs 等子目录做成软链接（比如指向 NAS 或外置盘）。初始化时会保留已有的目录链接，链接目录及其子目录（如 logs/curator）的权限交给其所有者。如果链接目标缺失、无法访问或不是目录，初始化会直接报存储错误并指出路径和目标——Hermes 不会替你替换链接或创建缺失目标，以免在外置卷未挂载时把数据写到本地盘。这时请检查链接、恢复挂载或修正目标、确认权限后再重试。注意 hermes doctor 会把这类问题报为存储问题而非 YAML 错误，不要用 hermes setup 去修，保留你现有的 config.yaml 即可。另外这只是目录可用性检查，不是挂载监控：目录存在并不代表目标卷真的挂上了。
安装方式自动识别：Hermes 会自动判断你是用 git 安装器、Docker 还是 NixOS 装的，hermes update 会打印对应路径的更新命令，无需设置任何环境变量；hermes doctor 的环境摘要里也会显示识别到的安装方式。

装好了？那就开聊吧。下期我们聊聊怎么配置你的第一个 agent。