Installation

Installation

Recommended: Install Script

curl -fsSL https://raw.githubusercontent.com/garagon/aguara/main/install.sh | bash

This downloads the latest release binary to ~/.local/bin. The script auto-detects your OS (Linux/macOS) and architecture (amd64/arm64).

Customize install location or version

# Specific version
VERSION=v0.3.1 curl -fsSL https://raw.githubusercontent.com/garagon/aguara/main/install.sh | bash

# Custom directory
INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/garagon/aguara/main/install.sh | bash

From Source (Go 1.25+)

go install github.com/garagon/aguara/cmd/aguara@latest

Make sure ~/go/bin is in your PATH:

# Add to ~/.bashrc or ~/.zshrc
export PATH="$HOME/go/bin:$PATH"

Pre-built Binaries

Download from the Releases page. Available for:

OS	Architecture	File
Linux	amd64	aguara_linux_amd64.tar.gz
Linux	arm64	aguara_linux_arm64.tar.gz
macOS	amd64 (Intel)	aguara_darwin_amd64.tar.gz
macOS	arm64 (Apple Silicon)	aguara_darwin_arm64.tar.gz
Windows	amd64	aguara_windows_amd64.zip

Verify Installation

aguara version

Expected output:

aguara v0.3.1 (go1.25, darwin/arm64)
Rules: 148 built-in

Requirements

• No runtime dependencies — single static binary
• Go 1.25+ only required if building from source
• Works offline — no network access needed during scanning