Installation

Requirements

• Go 1.26.2+ (for building from source)
• No CGO required — pure Go, zero C dependencies
• No external services required — SQLite embedded, no Redis/Postgres/Docker needed

From Source

git clone https://github.com/LumabyteCo/aibutler.git
cd aibutler
CGO_ENABLED=0 go build -o aibutler .
sudo mv aibutler /usr/local/bin/

From Release Binary

# Linux (amd64)
curl -sSL https://github.com/LumabyteCo/aibutler/releases/latest/download/aibutler_Linux_x86_64.tar.gz | tar xz

# macOS (Apple Silicon)
curl -sSL https://github.com/LumabyteCo/aibutler/releases/latest/download/aibutler_Darwin_arm64.tar.gz | tar xz

# Raspberry Pi (ARM64)
curl -sSL https://github.com/LumabyteCo/aibutler/releases/latest/download/aibutler_Linux_arm64.tar.gz | tar xz

sudo mv aibutler /usr/local/bin/

Docker

docker pull ghcr.io/lumabyteco/aibutler:latest
docker run -p 3377:3377 -v aibutler-data:/data ghcr.io/lumabyteco/aibutler

Or with Docker Compose:

# Standalone
docker compose up -d

# With Ollama (fully local AI, no API key needed)
docker compose -f docker-compose.ollama.yml up -d

# Full stack (+ Home Assistant)
docker compose -f docker-compose.full.yml up -d

Kubernetes

helm install aibutler deploy/helm/aibutler/

systemd Service

sudo deploy/systemd/install.sh

Verify Installation

aibutler version
aibutler integrity  # Check database health

Cross-Compilation

AI Butler builds for any platform Go supports:

# Linux ARM (Raspberry Pi)
CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o aibutler .

# Linux RISC-V
CGO_ENABLED=0 GOOS=linux GOARCH=riscv64 go build -o aibutler .

# Windows
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -o aibutler.exe .