Installation

Install ReductrAI on Linux, macOS, or Windows. Single binary, no dependencies.

Quick Install (Linux/macOS)

One command to download and install:

curl -sSL https://reductrai.com/install | sh

This will:

Detect your OS and architecture
Download the latest binary from GitHub
Install to /usr/local/bin/reductrai
Create a systemd service (Linux) or launchd plist (macOS)
Create data directory at ~/.reductrai

Supported Platforms

Linux AMD64

Ubuntu, Debian, RHEL, CentOS, Alpine

Linux ARM64

AWS Graviton, Raspberry Pi 4+

macOS Intel

macOS 11+ (Big Sur and later)

macOS Apple Silicon

M1, M2, M3 chips

Windows AMD64

Windows 10/11 (native)

Windows Installation

Run these commands in PowerShell (as Administrator):

        # Create installation directory

        mkdir "C:\Program Files\ReductrAI"

        # Download the latest Windows binary

        Invoke-WebRequest -Uri "https://github.com/reductrai/releases/releases/latest/download/reductrai-windows-amd64.exe" -OutFile "C:\Program Files\ReductrAI\reductrai.exe"

        # Add to PATH (run once)

        [Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Program Files\ReductrAI", "Machine")

Restart your terminal, then reductrai will work from anywhere.

Manual Installation

Download the binary for your platform from GitHub Releases:

Platform	Binary
Linux AMD64	`reductrai-linux-amd64`
Linux ARM64	`reductrai-linux-arm64`
macOS Intel	`reductrai-darwin-amd64`
macOS ARM64	`reductrai-darwin-arm64`
Windows AMD64	`reductrai-windows-amd64.exe`

        # Download (example: Linux AMD64)

        wget https://github.com/reductrai/releases/releases/latest/download/reductrai-linux-amd64

        # Make executable

        chmod +x reductrai-linux-amd64

        # Move to PATH

        sudo mv reductrai-linux-amd64 /usr/local/bin/reductrai

Start the Agent

        # Set your license key

        export REDUCTRAI_LICENSE=your-license-key

        # Start (Linux - systemd)

        sudo systemctl start reductrai

        # Start (macOS - launchd)

        launchctl load ~/Library/LaunchAgents/com.reductrai.agent.plist

        # Start (manual, any platform)

        reductrai start

Verify Installation

        # Check version

        reductrai version

        # Check status

        reductrai status

Point Your Telemetry

ReductrAI listens on port 8080 by default. Point your observability tools to:

http://localhost:8080

ReductrAI auto-detects telemetry format. Just point your agents — no config needed.

Next Steps

Configuration Reference — All environment variables
LLM Providers — Use your own LLM
Air-Gapped Deployment — For regulated environments