homebrew-edgee

Homebrew tap for Edgee CLI - an edge-native AI Gateway CLI tool.

Installation

Install Edgee CLI using Homebrew:

brew tap edgee-cloud/edgee
brew install edgee

Verify the installation:

edgee --version

Updating

To update to the latest version:

brew upgrade edgee

Uninstalling

To remove Edgee CLI:

brew uninstall edgee

Supported Platforms

This tap provides pre-built binaries for the following platforms:

• macOS:
  • Apple Silicon (ARM64 / aarch64-apple-darwin)
  • Intel (x86_64-apple-darwin)
• Linux:
  • ARM64 (aarch64-unknown-linux-gnu)
  • x86_64 (x86_64-unknown-linux-gnu)

Publishing a New Release

After a new edgee-cli release has been published on GitHub, update this tap by running:

./new-version.sh

What the script does:

1. Fetches release information from edgee-cloud/cli repository
2. Downloads binaries for all supported platforms
3. Calculates SHA256 checksums for each platform binary
4. Updates the formula (edgee.rb) with:
   • New version number
   • Updated SHA256 checksums for all platforms
5. Creates a versioned formula (edgee@<version>.rb) for the previous release
6. Creates a Git branch and commits the changes
7. Opens a pull request for review and merge

Prerequisites

• GitHub CLI (gh) installed and authenticated
• wget or curl for downloading binaries
• Write access to this repository

Manual Process

If you need to update manually:

1. Download the binaries for all platforms from the GitHub release
2. Calculate SHA256 checksums for each binary:

   # macOS
   shasum -a 256 edgee.aarch64-apple-darwin
   
   # Linux
   sha256sum edgee.x86_64-unknown-linux-gnu

3. Update edgee.rb:
   • Update the version field
   • Update the SHA256_BY_PLATFORM hash with new checksums
4. Create a versioned formula file for the previous release (if needed)
5. Commit and create a PR

Formula Structure

The formula (edgee.rb) uses platform-specific binary downloads:

• No Rust compilation required - uses pre-built binaries
• Platform detection via on_macos and on_linux blocks
• CPU architecture detection for ARM vs Intel
• SHA256 verification for security

Troubleshooting

Installation fails with "undefined method 'arch'"

If you see this error, you may be using the core Homebrew formula instead of this tap. Make sure to:

1. Tap this repository first: brew tap edgee-cloud/edgee
2. Install from the tap: brew install edgee

Binary not found error

If installation fails with "Binary not found", check:

1. The release exists on GitHub: https://github.com/edgee-cloud/cli/releases
2. The platform binary is available for your architecture
3. Your network connection allows downloading from GitHub

Version mismatch

If you're seeing an older version than expected:

brew update
brew upgrade edgee

Related Links

• Edgee CLI Repository
• Edgee Documentation
• Homebrew Documentation

License

Apache-2.0