Mac用户想在2026年8月稳定装上最新的 Hermes Agent v0.19.1，最稳妥的办法就是避开默认安装脚本的坑。

那个 install.sh 脚本目前（截至8月4日）还在拉取 main 分支，等于装的是未发布的开发快照，而不是打过标签的 v0.19.1。

直接运行它，大概率会装上不兼容的 Python 3.13.11 运行时，然后模型加载直接报错。

所以，别偷懒，按下面这套流程走，一劳永逸。

创建隔离用户环境

打开系统设置 → 用户与群组 → 点左上角锁图标输入密码解锁 → 点击“添加账户”。

账户类型选“管理员”，全名填“Hermes”，密码设一个容易记但别太简单的字符串 → 创建完成。

然后登出当前用户，在登录界面选 Hermes 用户登录。

这一步不能跳过——原用户残留的 Python/Node.js 环境会干扰 v0.19.1 的依赖解析，搞不好会装错版本。

安装 Homebrew 并配置基础工具链

打开终端，一行一行执行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install git curl wget python@3.12 node@22 ripgrep ffmpeg

注意：这里必须显式指定 python@3.12 和 node@22。 因为 v0.19.1 的 pyproject.toml 明确要求 Python >=3.12 且 <3.13，Node.js >=22.0.0。

如果图省事用 brew install python，默认装的是 3.13。到时候 Hermes 启动时报 ImportError: cannot import name 'cached_property' from 'functools'，哭都来不及。

精准安装 v0.19.1 发布版

方法一：从 GitHub Release 页面下载预编译二进制（推荐）

访问 https://github.com/NousResearch/hermes-agent/releases/tag/v0.19.1 → 找到 Assets 区域 → 下载 hermes-agent-v0.19.1-macos-universal.tar.gz。

解压后将 hermes 文件复制到 /usr/local/bin/（需要 sudo）。

运行 sudo chown $(whoami) /usr/local/bin/hermes 授予当前用户执行权限。

方法二：源码构建（适合需要调试或定制的人）

git clone --branch v0.19.1 --depth 1 https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
uv sync --python 3.12
uv run pip install -e .

注意：uv sync 必须带 --python 3.12 参数，否则 uv 会自动选中系统里的 Python 3.13，构建直接失败。

初始化并验证

第一步：重载 shell 配置

source ~/.zshrc

第二步：检查二进制路径与版本

which hermes

应返回 /usr/local/bin/hermes 或 ~/hermes-agent/.venv/bin/hermes。

然后运行：

hermes --version

必须精确输出 v0.19.1。 如果显示 v0.19.1+dev 或 main，说明要么没切到 tag 分支，要么二进制下载错了，重新来一遍。

第三步：启动测试

hermes start

观察终端输出，出现 Hermes Agent is running on http://localhost:8000 且没有红色 ERROR 日志，那就稳了。

至此，整个安装流程走完，可以放心用。