Installation

ZeptoClaw is distributed as a single static binary. Choose the installation method that works best for your platform.

Prerequisites

• macOS or Linux — ZeptoClaw runs on both platforms (x86_64 and ARM64)
• No runtime dependencies — The binary is fully self-contained

Install with script (recommended)

curl -fsSL https://raw.githubusercontent.com/qhkm/zeptoclaw/main/install.sh | sh

This downloads the latest release binary for your platform and places it in your PATH.

Install with Homebrew (macOS/Linux)

brew install qhkm/tap/zeptoclaw

Install with Cargo

Build from source using Rust’s package manager:

cargo install zeptoclaw --git https://github.com/qhkm/zeptoclaw

Docker

Run ZeptoClaw in a container:

docker pull ghcr.io/qhkm/zeptoclaw:latest

# Run agent mode
docker run --rm ghcr.io/qhkm/zeptoclaw:latest agent -m "Hello"

# Run gateway mode with config
docker run -d \
  -v ~/.zeptoclaw:/root/.zeptoclaw \
  -e ZEPTOCLAW_PROVIDERS_ANTHROPIC_API_KEY=sk-... \
  ghcr.io/qhkm/zeptoclaw:latest gateway

Download binary

Pre-built binaries are available on the releases page:

# Linux x86_64
curl -L https://github.com/qhkm/zeptoclaw/releases/latest/download/zeptoclaw-linux-x86_64 -o zeptoclaw
chmod +x zeptoclaw

# macOS (Apple Silicon)
curl -L https://github.com/qhkm/zeptoclaw/releases/latest/download/zeptoclaw-macos-aarch64 -o zeptoclaw
chmod +x zeptoclaw

# macOS (Intel)
curl -L https://github.com/qhkm/zeptoclaw/releases/latest/download/zeptoclaw-macos-x86_64 -o zeptoclaw
chmod +x zeptoclaw

Build from source

To build from source, you need Rust 1.70+:

git clone https://github.com/qhkm/zeptoclaw.git
cd zeptoclaw

# Build release binary (~4MB)
cargo build --release

# Verify
./target/release/zeptoclaw --version

Verify installation

zeptoclaw --version
# zeptoclaw 0.5.0

zeptoclaw --help
# Shows available commands

Next steps

Now that ZeptoClaw is installed, follow the quick start guide to run your first agent interaction.