feat: Add GAIA to Homebrew for macOS installation

[kovtcharov-amd]

Summary

Add GAIA to Homebrew as a Cask (for the GUI app) and/or a Formula (for the CLI), making it the standard macOS installation method.

This was suggested in #745, where users encountered friction with the unsigned DMG installer requiring Gatekeeper workarounds. A Homebrew Cask would provide a trusted, familiar installation path for macOS users.

Motivation

• macOS users expect brew install as the standard way to install apps
• Removes friction from the current DMG install flow (Gatekeeper warnings, manual xattr -cr commands)
• Increases discoverability and credibility of the project
• Keeps GAIA up-to-date automatically via brew upgrade

Proposed Approach

Option A: Homebrew Cask (GUI app)

Distribute the signed .dmg via homebrew-cask or a custom tap:

cask "gaia" do
  version "0.17.2"
  sha256 "..."
  url "https://github.com/amd/gaia/releases/download/v#{version}/gaia-agent-ui-#{version}-arm64.dmg"
  name "GAIA"
  desc "AMD's generative AI framework for local AI applications"
  homepage "https://amd-gaia.ai"
  app "GAIA.app"
end

Option B: Homebrew Formula (CLI)

Distribute the gaia Python CLI via a formula wrapping uv/pipx install.

Option C: AMD Tap (Recommended)

Create an amd/homebrew-gaia tap to host both:

brew tap amd/gaia
brew install gaia          # CLI
brew install --cask gaia   # GUI

Prerequisites

• Signed macOS builds in CI/CD — partially addressed in fix(ci): ad-hoc sign macOS DMG instead of skipping code signing #765
• Stable release artifact URLs on GitHub Releases
• Decide: official homebrew-cask submission vs. custom amd/homebrew-gaia tap

References

• [Bug]: Where is the DMG installer #745 — DMG installer issue where Homebrew was suggested
• fix(ci): ad-hoc sign macOS DMG instead of skipping code signing #765 — Ad-hoc code signing fix
• https://docs.brew.sh/Cask-Cookbook
• https://docs.brew.sh/Formula-Cookbook

[mac2net]

Sorry, I disappeared. Using Brew doesn't entirely remove friction but it enhances trust and Brew is strengthening its polices later this year..

https://workbrew.com/blog/homebrew-5-0-0

[kovtcharov]

Adding it to Brew makes sense, we will do it in a near release.