Files
hermes-agent/packaging/homebrew

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-whisper now lives in the voice extra, which keeps wheel-only transitive dependencies out of the base Homebrew formula.
  • The wrapper exports HERMES_BUNDLED_SKILLS, HERMES_OPTIONAL_SKILLS, and HERMES_MANAGED=homebrew so packaged installs keep runtime assets and defer upgrades to Homebrew.

Typical update flow:

  1. Bump the formula url, version, and sha256.
  2. Refresh Python resources with brew update-python-resources --print-only hermes-agent.
  3. Keep ignore_packages: %w[certifi cryptography pydantic].
  4. Verify brew audit --new --strict hermes-agent and brew test hermes-agent.