Step 1 - Install the binary

This step downloads the hivel-agent binary you'll use for every command in the rest of this guide. No Docker or other runtime is required, it's a single static binary.

Linux / macOS / Windows (Git Bash or WSL)

curl -fsSL https://getagent.hivel.ai/get-agent.sh | bash

Prefer to inspect before running:

curl -fsSL https://getagent.hivel.ai/get-agent.sh -o get-agent.sh
bash get-agent.sh

For a specific version instead of the latest:

bash get-agent.sh v1.0.0

The script:

1. Detects your OS and architecture (linux/darwin/windows × amd64/arm64)

2. Downloads the requested version (default: latest)

3. Verifies the SHA256 checksum

4. Places ./hivel-agent in your current directory

Confirm it works:

./hivel-agent version

macOS note: if you see "could not verify", run: xattr -d com.apple.quarantine hivel-agent

Windows (native PowerShell)

No Git Bash or WSL required - just PowerShell:

Invoke-WebRequest -Uri https://getagent.hivel.ai/get-agent.ps1 -OutFile get-agent.ps1
.\get-agent.ps1

For a specific version instead of the latest:

/.\get-agent.ps1 -Version v1.0.0

This downloads hivel-agent.exe into your current directory and verifies its SHA256 checksum, same as the bash installer. No jq or any other tool required.

Confirm it works:

.\hivel-agent.exe version

Supported platforms

OS	amd64	arm64
Linux	✓	✓
macOS	✓	✓
Windows (native PowerShell, or Git Bash / WSL)	✓	-

prerequisites and Set-up

Step 2