HermesAgent如何在苹果macOS系统上快速部署安装？

本文共计874个文字，预计阅读时间需要4分钟。

如果您是+，请直接输出结果。

一、使用官方一键安装脚本（推荐新手）

该方法通过预置脚本自动处理 Python 环境、Node.js、ripgrep、ffmpeg 及 Git 依赖，并完成虚拟环境创建与全局命令注册，全程无需手动干预，适用于未安装开发工具链的纯净 macOS 系统。

1、打开终端（Terminal），可通过 Spotlight 搜索「终端」或前往「访达 → 应用程序 → 实用工具 → 终端」启动。

2、复制并粘贴以下命令后按回车执行：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

3、等待脚本自动完成下载、权限配置、依赖安装及环境变量写入；过程中将依次安装 Python 3.11+、Node.js v22、ripgrep 和 ffmpeg。

4、安装完成后，运行 source ~/.zshrc 以重载 shell 配置（若使用旧版 macOS Catalina 之前系统，请改用 source ~/.bashrc）。

5、验证是否成功：在终端输入 hermes --version，确认输出版本号且无报错信息。

二、基于 Homebrew 的包管理器安装（适合已有 Homebrew 用户）

该方法利用 Homebrew 生态统一管理依赖，确保版本兼容性与后续升级一致性，所有组件均安装至用户目录，避免系统级污染，适合已配置好 Homebrew 的进阶用户。

1、确认 Homebrew 已正确安装：在终端执行 brew --version，若提示 command not found，请先运行 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" 安装。

2、添加 Hermes Agent 官方仓库源：brew tap hermesagent/tap

3、执行安装命令：brew install hermesagent

4、检查安装路径：二进制文件默认位于 /opt/homebrew/bin/hermesagent（Apple Silicon）或 /usr/local/bin/hermesagent（Intel），可直接调用。

5、初始化配置：hermes setup 启动交互式向导，选择 Quick setup 并按提示完成基础参数设定。

三、Docker 容器化部署（适配 Apple Silicon 与 Intel 双架构）

该方法通过 Docker Desktop 封装完整运行时环境，彻底规避 macOS 权限限制、Python 版本冲突及本地依赖缺失问题，所有数据卷挂载至本地指定目录，保障隐私与可控性。

1、前往 https://www.docker.com/products/docker-desktop 下载并安装最新版 Docker Desktop，确保其在 macOS Sonoma/Ventura/Monterey 上正常运行并已启动。

2、创建专属部署目录：mkdir ~/hermes-docker && cd ~/hermes-docker

3、新建 docker-compose.yml 文件，内容如下：

4、在终端中执行：docker-compose up -d

5、验证容器状态：docker ps | grep hermes，确认服务处于 Up 状态且端口映射正常。