Get Wizard running.

Latest release v1.0.2 · published August 25, 2026

See what changed in the changelog

macOS / Linux — Homebrew

brew tap Wizard-AIA/wizard && brew install wizard && wizard init && wizard start

Python 3.12+, Node 20+, and either Ollama or LM Studio for local models. Docker Desktop is recommended but not required — code runs in a sandboxed subprocess without it.

Or grab a standalone binary

Five platform builds per release, cross-compiled and self-tested in CI.

macOS (Apple Silicon)Wizard-v1.0.2-darwin-arm64.zip · 5.5 MB

Download

macOS (Intel)Wizard-v1.0.2-darwin-amd64.zip · 5.7 MB

Download

Linux (x86_64)Wizard-v1.0.2-linux-amd64.zip · 5.8 MB

Download

Linux (arm64)Wizard-v1.0.2-linux-arm64.zip · 5.5 MB

Download

Windows (x86_64)Wizard-v1.0.2-windows-amd64.zip · 5.9 MB

Download

Software Bill of Materials (SPDX JSON) — attached to every release

Download SBOM

After downloading

./cli/wizard init      # checks Python 3.12+/Node 20+, installs dependencies
./cli/wizard start     # launches both in the background, opens a browser

Unzip first, then run these from inside the extracted folder. Open http://localhost:3000once it starts — you don't need to install a model first, use /models in the app.

Docker Compose

One container per session, isolated by cap_drop=ALL. Backend on :8000, frontend on :3000.

git clone https://github.com/Wizard-AIA/Wizard-w2.git
cd Wizard-w2
docker compose up --build -d

Smaller sandbox image: SANDBOX_TIER=core docker compose up --build -d. No sandbox image at all: EXECUTION_BACKEND=host docker compose up -d.

GitHub Codespaces

An instant full-stack environment in your browser — no clone, no toolchain, no build step.

Open in GitHub Codespaces

Build from source

The wizard CLI is a single Go binary; everything else is the same checkout.

git clone https://github.com/Wizard-AIA/Wizard-w2.git && cd Wizard-w2
cd cli && go build -o wizard ./cmd/wizard && cd ..
./cli/wizard init
./cli/wizard start

Full installation guide in the docs →