推荐新手使用官方一键安装脚本：执行curl -fssl https://raw.githubusercontent.com/nousresearch/hermes-agent/main/scripts/install.sh | bash，脚本自动配置python 3.11+、node.js、ripgrep等依赖并注册hermes命令，最后运行hermes --version验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您是 macOS 用户，希望在苹果电脑上快速完成 HermesAgent 的部署，则可能是由于缺乏明确的安装路径或对系统环境要求不熟悉导致进展受阻。以下是针对该场景的多种可行部署方式：
一、使用官方一键安装脚本（推荐新手）
该方法通过预置脚本自动处理 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 状态且端口映射正常。
