hermes-agent/packaging/homebrew
Teknium e64b047663
chore: prepare Hermes for Homebrew packaging (#4099)
Co-authored-by: Yabuku-xD <78594762+Yabuku-xD@users.noreply.github.com>
2026-03-30 17:34:43 -07:00
..
hermes-agent.rb chore: prepare Hermes for Homebrew packaging (#4099) 2026-03-30 17:34:43 -07:00
README.md chore: prepare Hermes for Homebrew packaging (#4099) 2026-03-30 17:34:43 -07:00

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.