macos上通过homebrew部署hermes agent需四步：一、添加官方tap源并更新；二、安装主程序并验证版本；三、配置zsh自动补全；四、手动初始化server模式配置文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已在 macOS 上安装 Homebrew，并希望利用其包管理能力完成 Hermes Agent 的部署，则可跳过 Python 环境手动配置环节，直接通过官方 tap 获取稳定版本。该方式能自动处理依赖版本对齐与二进制路径注册，适用于已配置好 shell 初始化脚本的日常开发环境。
一、启用 Hermes Agent 官方 tap 源
Homebrew 默认不包含 Hermes Agent，需先添加其维护的专用仓库，以确保后续安装调用的是经签名验证、适配 Apple Silicon（arm64）或 Intel（x86_64）架构的正式发布版本。
1、打开终端（Terminal），执行命令添加 tap：brew tap hermesagent/tap
2、更新本地公式索引，确保获取最新可用版本：brew update
二、安装 Hermes Agent 主程序
启用 tap 后，Homebrew 可识别 hermesagent 公式，将自动拉取预编译二进制、校验 SHA256 哈希值，并将其安装至标准路径（/opt/homebrew/bin/hermesagent 或 /usr/local/bin/hermesagent），同时注册为全局可执行命令。
1、运行安装命令：brew install hermesagent
2、安装完成后，验证二进制是否存在且具备执行权限：ls -l $(which hermesagent)
3、确认版本信息输出正常：hermesagent --version
部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流：PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景：(1) "安装我的自动化服务"，(2) "部署所有 Automato...
三、配置 Shell 初始化以支持自动补全
Homebrew 安装的 Hermes Agent 默认不启用命令行自动补全功能，需显式触发补全脚本生成并加载，否则在输入 hermesagent tab 时无法提示子命令。
1、生成 Zsh 补全脚本（macOS 默认 shell）：hermesagent completion zsh > $(brew --prefix)/share/zsh/site-functions/_hermesagent
2、确保 ~/.zshrc 中已启用 site-functions 加载（如无则追加）：fpath=($(brew --prefix)/share/zsh/site-functions $fpath)
3、重新加载配置：source ~/.zshrc
四、初始化运行时配置
首次运行前必须生成用户级配置文件，否则启动时将报错缺失 ~/.hermesagent/config.yaml。Homebrew 安装版本不自动触发初始化向导，需手动执行 init 命令指定服务模式。
1、创建初始配置目录：mkdir -p ~/.hermesagent
2、生成最小化服务器模式配置：hermesagent init --mode=server
3、检查配置文件是否已写入：ls -l ~/.hermesagent/config.yaml
