HARPER·AI

Installation

Harper can be installed via Homebrew, providing an easy way to manage updates and dependencies on macOS.

Add the tap
brew tap harpertoken/tap
Install Harper
brew install harpertoken/tap/harper-ai
Verify installation
harper --version
Upgrading
brew upgrade harpertoken/tap/harper-ai
Uninstalling
brew uninstall harpertoken/tap/harper-ai

Build from source

The Homebrew formula builds Harper from source, which requires:

  • Rust toolchain
  • CMake (for native dependencies)
  • OpenSSL (for HTTPS support)

Initial compilation takes several minutes. Subsequent upgrades are faster due to cached dependencies.

Troubleshooting

Build fails

Ensure Rust is installed:

rustup update
Binary not found after installation

Verify the binary is in your PATH:

which harper

If not found, add Homebrew binaries to your PATH:

export PATH="$(brew --prefix)/bin:$PATH"
Permission errors

Ensure your Homebrew installation is properly configured:

brew doctor