Installation

zap can be installed in several ways. Choose the method that works best for you.

Quick Install (Recommended)

Run the install script:

curl -fsSL https://zap-zig.github.io/install.sh | sh

Build from Source

Requires Zig 0.15.2 or later.

# Clone the repository
git clone https://github.com/zap-zig/zap.git
cd zap

# Build release binary
zig build -Doptimize=ReleaseFast

# Install to /usr/local/bin
sudo zig build -Doptimize=ReleaseFast --prefix /usr/local install

# Or install to ~/.local/bin
zig build -Doptimize=ReleaseFast --prefix ~/.local install

Verify Installation

zap version
# zap version 0.1.1

System Requirements

• Linux (x86_64, aarch64)
• macOS (x86_64, aarch64)

Python Requirements

zap can manage Python for you! If you don't have Python installed, use:

# Download and install Python 3.12
zap python install 3.12

# Initialize project with the installed Python
zap init --python 3.12

Alternatively, zap works with any system Python 3.8 or later:

# Use system Python
zap init

# Use specific system Python
zap init --python 3.11

What Gets Installed

Uninstall

# Remove the binary
sudo rm /usr/local/bin/zap

# Clear the cache (optional)
rm -rf ~/.cache/zap

# Remove managed Python installations (optional)
rm -rf ~/.zap