必须确保Python 3.12环境、终端完全磁盘访问权限及GitHub直连或代理配置，否则安装脚本将静默失败；需依次验证git/curl/python3版本，勾选Terminal权限，再执行v0.16专用安装脚本或手动克隆分支，最后通过hermes setup配置minimax-cn提供商并启用记忆功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 macOS 上成功运行 Hermes Agent v0.16，必须确保 Python 3.12 环境就绪、终端具备完全磁盘访问权限、GitHub 资源可直连或已配代理，否则安装脚本会在克隆仓库或拉取依赖时静默失败，后续所有配置都将无效。
环境准备与权限校验
第一步：打开终端，依次执行以下命令验证基础工具链是否可用：
输入 git --version → 若返回 git version 2.45.2 或更高，说明 Git 正常；若提示 command not found，运行 xcode-select --install 安装命令行工具。
输入 curl --version → 必须有输出，macOS 自带 curl，但 SIP 异常时可能被禁用，此时需重启终端重试。
输入 python3 --version → 【必须为 3.10～3.12 之间】，v0.16 不兼容 Python 3.13，若显示 3.13.x，请用 pyenv 或 Homebrew 单独安装 3.12.3：brew install python@3.12，再执行 brew link --force python@3.12。
第二步：检查终端是否拥有“完全磁盘访问”权限。前往「系统设置 → 隐私与安全性 → 完全磁盘访问」，确认 Terminal.app 已勾选。未勾选会导致虚拟环境创建失败且无明确报错。
一键安装 Hermes Agent v0.16
方法一：官方安装脚本（推荐）
在终端中粘贴并执行：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/v0.16/scripts/install.sh | bash
该脚本会自动检测 Python 版本、创建隔离虚拟环境、安装 Node.js（用于 TUI）、拉取 v0.16 分支代码、注册 hermes 全局命令。整个过程约 2～4 分钟，网络波动时可能卡在 Cloning into 'hermes-agent'，此时请检查 GitHub 连通性（curl -I https://github.com 应返回 200）。
方法二：手动指定分支安装（适用于脚本失效时）
先克隆指定版本：git clone --branch v0.16 https://github.com/NousResearch/hermes-agent.git && cd hermes-agent
再创建并激活虚拟环境：python3.12 -m venv .venv && source .venv/bin/activate
安装依赖：pip install --upgrade pip && pip install -r requirements.txt → 这一步会安装 openai>=1.42.0 和 anthropic>=0.42.0 等关键包，若报 ModuleNotFoundError: No module named 'setuptools'，先运行 pip install setuptools。
配置 MiniMax-CN 推理服务
第一步：登录 MiniMax 控制台，进入「API Key」页面，点击「创建新 Key」，复制生成的密钥字符串。
第二步：运行交互式配置向导：hermes setup
第三步：按提示操作：
① 选择 Provider：输入 minimax-cn（不是 minimax，国内用户必须选此选项，否则请求会超时）
② 输入 API Key：粘贴刚才复制的密钥，回车确认
③ 设置默认模型：推荐选 abab6.5s-chat（v0.16 已适配该模型的 streaming 协议）
④ 是否启用记忆功能：输入 y，否则多轮对话状态无法持久化
注意：向导结束后会自动生成 ~/.hermes/config.yaml，其中 provider: minimax-cn 和 api_key: *** 必须存在且未被注释，否则启动时报 Missing API key for provider。
启动与验证
执行 hermes 启动服务。
看到终端输出 Hermes Agent is running on http://localhost:8000 且光标停止闪烁，表示服务已就绪。
打开浏览器访问 http://localhost:8000，加载出 Web UI 界面，并在输入框发送 “你好”，收到结构化回复即完成部署。
