Agent Install

Fresh Install

For a brand new setup, install Homebrew and the agent. The agent automatically installs its own dependencies (FFmpeg, Whisper, Docker/Colima) on first launch.

1. Install Homebrew (if not already installed)

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Download and install the agent

   curl -O https://grail-releases.s3.us-east-1.amazonaws.com/agent/darwin-arm64/1.0.0-beta.20/grail-agent
   chmod +x grail-agent
   ./grail-agent install

   The agent binary is code-signed and notarized by Apple, so macOS will not block it.

Tip

On first start, the agent detects and installs missing dependencies via Homebrew: FFmpeg, Whisper, Docker, and Colima. Colima is registered as a brew service so it starts automatically on login. You can check installed dependency versions on the agent card in the web app.

Update (pre-beta 8)

If you’re updating from a version before beta 8 (or an unknown version), download the latest binary and reinstall:

curl -O https://grail-releases.s3.us-east-1.amazonaws.com/agent/darwin-arm64/1.0.0-beta.20/grail-agent
chmod +x grail-agent
./grail-agent install

Verify the update:

grail-agent version
grail-agent status

Update (beta 8+)

If you’re on beta 8 or later, the agent can update itself:

1. Download the latest agent

   grail-agent update

2. Install helper scripts

   grail-agent install