macos部署hermes agent需先验证并安装git/curl/homebrew，配置github代理访问，授予终端完全磁盘访问权限，必要时关闭sip以允许pip安装，并将~/.local/bin加入path后source生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您计划在 macOS 系统上部署 Hermes Agent，但安装过程因环境缺失或权限不足而中断，则很可能是由于系统缺少必要工具链、网络无法访问 GitHub 资源，或终端未获得足够的文件系统操作权限。以下是完成环境准备与权限设置的关键步骤：
一、验证并安装基础依赖工具
macOS 默认不预装 Git、curl、Homebrew 等关键工具，而 Hermes Agent 的官方安装脚本依赖它们拉取代码、解析依赖及管理环境。缺失任一工具均会导致脚本中止或静默失败。
1、打开终端（Terminal），依次执行以下命令检测基础工具是否存在：
2、输入 git --version，若返回类似 git version 2.43.0 的输出则 Git 已就绪；否则需手动安装 Xcode Command Line Tools：xcode-select --install。
3、输入 curl --version，确认输出版本信息；若提示 command not found，请检查系统完整性保护（SIP）是否异常禁用系统二进制路径，或尝试重启终端后重试。
4、输入 brew --version，若未安装 Homebrew，运行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" 完成安装，并确保其 bin 目录已加入 PATH（通常为 /opt/homebrew/bin 或 /usr/local/bin）。
二、配置 GitHub 可访问性与代理支持
Hermes Agent 安装脚本需从 GitHub（raw.githubusercontent.com 与 github.com）下载 install.sh、requirements.txt 及子模块，若网络策略拦截或 DNS 解析失败，将卡在“Cloning into 'hermes-agent'...”阶段且无明确报错。
1、在终端中执行：curl -I https://github.com，观察响应状态码是否为 200；若超时或返回 403，说明网络受限。
2、若使用代理，请为 Git 配置 HTTPS 代理：git config --global https.proxy http://127.0.0.1:7890（端口按实际代理工具调整）。
3、同时为 curl 设置临时代理以验证连通性：curl -x http://127.0.0.1:7890 -I https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh。
4、如需全局生效，可将 export https_proxy=http://127.0.0.1:7890 写入 ~/.zshrc 并执行 source ~/.zshrc。
三、授予终端完全磁盘访问权限
自 macOS Monterey 起，终端应用默认无权读写“下载”、“文稿”、“桌面”等用户目录，而 Hermes Agent 的 venv 创建、日志写入、MEMORY.md 持久化均需该权限。未授权将导致 Permission denied 错误，且错误信息常被 pip 或 python 隐藏。
1、点击屏幕左上角 Apple 图标 → “系统设置” → “隐私与安全性” → “完全磁盘访问”。
2、点击右下角锁形图标，输入管理员密码解锁设置。
3、点击“+”号，前往 /Applications/Utilities/，选择“终端.app”并添加。
4、重启终端应用，确保新权限立即生效；可通过 touch ~/Desktop/test-perm.txt && rm ~/Desktop/test-perm.txt 验证写入能力。
四、关闭 SIP 对 /usr/local 的限制（仅当使用系统 Python 时）
若未通过 Homebrew 安装 Python，而直接调用系统自带的 /usr/bin/python3，其 site-packages 路径位于受 SIP 保护的 /usr/local/lib/python3.x/site-packages，pip install 将失败并提示 Operation not permitted。
1、重启 Mac，按住 Command+R 进入恢复模式。
2、顶部菜单栏选择“实用工具” → “终端”，执行：csrutil disable。
3、重启系统后，在终端中运行 python3 -m pip install --upgrade pip 验证是否可写。
4、注意：此操作降低系统安全性，仅限临时调试；部署完成后建议重新启用 SIP（csrutil enable）。
五、配置 shell 初始化路径与权限继承
安装脚本生成的 hermes 命令需注册至系统 PATH，否则执行 hermes version 会提示 command not found。该注册依赖 shell 配置文件（~/.zshrc 或 ~/.bash_profile）的正确加载及可写权限。
1、确认当前 shell 类型：echo $SHELL，macOS Ventura 及更新版本默认为 /bin/zsh。
2、检查 ~/.zshrc 是否存在且可写：ls -l ~/.zshrc；若不存在，执行 touch ~/.zshrc。
3、向 ~/.zshrc 追加 PATH 行：echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc（官方脚本默认安装至 ~/.local/bin）。
4、重新加载配置：source ~/.zshrc，再运行 which hermes 验证命令是否可见。
