hermes agent 在 macos 上可一键安装并配置：执行 curl -fssl ... | bash 后 source ~/.zshrc，再运行 hermes setup 选择 openrouter 等模型提供商并输入 api key 即可启动。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在苹果电脑上安装 Hermes Agent，但无法正常启动或执行命令，则可能是由于系统环境未满足最低要求或安装流程未正确完成。以下是针对 macOS 系统的完整安装与配置步骤：
一、确认系统与环境前提
macOS 是 Hermes Agent 官方明确支持的操作系统之一，但需确保满足基础运行条件。安装脚本虽可自动补全依赖，但部分前置组件仍需用户手动验证或预装，以避免后续中断。
1、打开终端（Terminal），输入 python3 --version 检查 Python 版本，必须为 3.10 或以上（推荐 3.11）。
2、执行 git version 验证 Git 是否已安装；若提示 command not found，请先运行 brew install git（如未安装 Homebrew，需先执行官方安装命令）。
3、确认 Shell 类型：macOS 默认使用 zsh，检查配置文件是否为 ~/.zshrc；若使用 bash，则对应为 ~/.bashrc。
二、一键式自动安装（推荐）
该方式由官方维护，适用于绝大多数 macOS 用户，能自动检测并安装 Python 3.10+、Node.js、Git、ripgrep 等全部运行时依赖，并创建全局 hermes 命令。
1、在终端中粘贴并执行以下命令：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash。
2、等待终端输出全部绿色勾选标记（✅），表示安装完成。
3、重新加载 Shell 配置：source ~/.zshrc（zsh 用户）或 source ~/.bashrc（bash 用户）。
4、验证安装结果：输入 hermes version，应返回版本号；再运行 hermes doctor，确认所有依赖状态为 OK。
三、手动安装（适用于定制化需求）
当需要修改源码、调试特定模块或规避自动脚本限制时，可采用手动安装流程。此方式对路径、虚拟环境及依赖管理有更精细控制。
1、通过 Homebrew 安装 Python 3.11：brew install python@3.11。
2、安装高效包管理器 uv：curl -LsSf https://astral.sh/uv/install.sh | sh。
3、克隆项目仓库：git clone https://github.com/NousResearch/hermes-agent.git && cd hermes-agent。
4、创建并激活虚拟环境：uv venv venv --python=3.11 && source venv/bin/activate。
5、安装 Hermes Agent 及全部扩展依赖：uv pip install -e ".[all]"。
6、初始化配置：hermes setup，按向导完成模型提供商、API Key 及消息平台设置。
四、模型配置与快速验证
安装完成后需指定大模型服务来源，否则 hermes chat 将无法响应。macOS 用户可优先选用 OpenRouter 免费模型以零成本启动。
1、运行 hermes setup，在 Inference Provider 步骤选择 OpenRouter。
2、访问 https://openrouter.ai/keys 注册账号并生成 API Key，复制后粘贴至终端（不显示字符属正常）。
3、模型推荐选择 nvidia/nemotron-3-super-120b-a12b:free 或 google/gemma-4-31b-it:free。
4、完成配置后，执行 hermes chat -q "Hello"，收到有效回复即表示全流程贯通。
五、常见问题即时修复
部分 macOS 用户在首次运行时可能遇到命令未识别或权限异常，此类问题多源于 Shell 路径未刷新或 SIP 机制限制，无需重装即可解决。
1、若输入 hermes 提示 command not found，请再次执行 source ~/.zshrc 并确认 ~/.hermes/bin 已加入 PATH。
2、若出现 Permission denied 错误，检查终端是否以标准用户身份运行（非 root），并确认 /usr/local/bin 目录具有写入权限。
3、若 hermes setup 卡在 API Key 输入环节，可临时改用环境变量方式：export OPENROUTER_API_KEY="sk-or-v1-xxxxxxxx"，再运行命令。
