> For the complete documentation index, see [llms.txt](https://docs.hivel.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hivel.ai/hybrid-hivel-agent/3.-prerequisites-and-set-up/step-1-install-the-binary.md).
# 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) | ✓ | - |
{% columns %}
{% column %} prerequisites and Set-up
{% endcolumn %}
{% column %}
{% endcolumn %}
{% column %} Step 2
{% endcolumn %}
{% endcolumns %}