Homebrew packaging notes for Hermes Agent.
Use packaging/homebrew/hermes-agent.rb as a tap or homebrew-core starting point.
Key choices:
- Stable builds should target the semver-named sdist asset attached to each GitHub release, not the CalVer tag tarball.
faster-whispernow lives in thevoiceextra, which keeps wheel-only transitive dependencies out of the base Homebrew formula.- The wrapper exports
HERMES_BUNDLED_SKILLS,HERMES_OPTIONAL_SKILLS, andHERMES_MANAGED=homebrewso packaged installs keep runtime assets and defer upgrades to Homebrew.
Typical update flow:
- Bump the formula
url,version, andsha256. - Refresh Python resources with
brew update-python-resources --print-only hermes-agent. - Keep
ignore_packages: %w[certifi cryptography pydantic]. - Verify
brew audit --new --strict hermes-agentandbrew test hermes-agent.