<!-- source: https://deepwiki.com/qhkm/zeptoclaw/2.1-installation -->

# Installation

- .github/workflows/ci.yml
- .github/workflows/e2e.yml
- .github/workflows/release.yml
- CHANGELOG.md
- README.md
- deploy/homebrew/zeptoclaw.rb
- install.sh
- landing/zeptoclaw/docs/astro.config.mjs
- landing/zeptoclaw/docs/src/assets/logo.svg
- landing/zeptoclaw/docs/src/content/docs/getting-started/installation.md
- landing/zeptoclaw/docs/src/content/docs/index.mdx
- landing/zeptoclaw/docs/src/content/docs/reference/cli.md
- landing/zeptoclaw/docs/src/styles/custom.css
- landing/zeptoclaw/index.html
- src/tools/screenshot.rs

## Purpose and Scope

This page covers all methods for installing ZeptoClaw on supported platforms. ZeptoClaw is distributed as a single, ultra-lightweight Rust binary (~6MB) designed for minimal resource consumption and high-speed startup [README.md37-40](https://github.com/qhkm/zeptoclaw/blob/2c743d31/README.md?plain=1#L37-L40) [README.md50-51](https://github.com/qhkm/zeptoclaw/blob/2c743d31/README.md?plain=1#L50-L51) After installation, proceed to the [Quick Start Guide](/qhkm/zeptoclaw/2.2-quick-start-guide) for initial configuration. For deployment strategies including containerized gateway modes, see [Deployment Options](/qhkm/zeptoclaw/12.1-deployment-options).

## System Requirements

ZeptoClaw is a self-contained static binary with minimal runtime dependencies.

**Runtime Dependencies:**

- sh — Required for the shell tool and basic command execution.
- git — Optional; required for the install_skill tool and GitHub-based skill management CHANGELOG.md 83
- ca-certificates — Required for HTTPS communication with LLM provider APIs.

Sources: [README.md36-42](https://github.com/qhkm/zeptoclaw/blob/2c743d31/README.md?plain=1#L36-L42) [install.sh9-21](https://github.com/qhkm/zeptoclaw/blob/2c743d31/install.sh#L9-L21) [landing/zeptoclaw/docs/src/content/docs/getting-started/installation.md11-15](https://github.com/qhkm/zeptoclaw/blob/2c743d31/landing/zeptoclaw/docs/src/content/docs/getting-started/installation.md?plain=1#L11-L15)

## Installation Methods

### 1. Binary Releases (Recommended)

The fastest way to install ZeptoClaw is using the automated install script which handles platform detection and checksum verification.

#### One-Liner Installation

```

```

The `install.sh` script performs the following logic:

1. Platform Detection : Identifies OS via uname -s install.sh 9-14 and Architecture via uname -m install.sh 16-21
2. Download : Fetches the specific artifact (e.g., zeptoclaw-linux-aarch64 ) and its corresponding .sha256 file from GitHub Releases install.sh 23-33 install.sh 62-64
3. Verification : Validates the binary integrity using sha256sum or shasum install.sh 68-85
4. Deployment : Moves the binary to ~/.local/bin (preferred) or /usr/local/bin install.sh 38-44

Sources: [install.sh1-132](https://github.com/qhkm/zeptoclaw/blob/2c743d31/install.sh#L1-L132) [README.md84-87](https://github.com/qhkm/zeptoclaw/blob/2c743d31/README.md?plain=1#L84-L87)

### 2. Homebrew (macOS / Linux)

ZeptoClaw is available via a dedicated tap for users of the Homebrew package manager.

```

```

To update an existing installation:

```

```

Sources: [README.md88-89](https://github.com/qhkm/zeptoclaw/blob/2c743d31/README.md?plain=1#L88-L89) [landing/zeptoclaw/docs/src/content/docs/getting-started/installation.md24-28](https://github.com/qhkm/zeptoclaw/blob/2c743d31/landing/zeptoclaw/docs/src/content/docs/getting-started/installation.md?plain=1#L24-L28)

### 3. Cargo Install (Build from Source)

For users who prefer building from source or need specific feature flags enabled. This requires a Rust toolchain (Stable).

```

```

**Common Feature Flags:**

- --features panel : Enables the Axum-based control panel web UI CHANGELOG.md 11
- --features google : Enables Google Workspace tools (Gmail/Calendar) CHANGELOG.md 12
- --features peripheral-esp32 : Enables ESP32 hardware control tools CHANGELOG.md 60
- --features peripheral-rpi : Enables Raspberry Pi GPIO/I2C tools CHANGELOG.md 55
- --features android : Enables ADB-based Android device control CHANGELOG.md 96
- --features screenshot : Enables headless Chromium-based web screenshots src/tools/screenshot.rs 1-5

Sources: [README.md94-96](https://github.com/qhkm/zeptoclaw/blob/2c743d31/README.md?plain=1#L94-L96) [CHANGELOG.md11-13](https://github.com/qhkm/zeptoclaw/blob/2c743d31/CHANGELOG.md?plain=1#L11-L13) [.github/workflows/ci.yml82-99](https://github.com/qhkm/zeptoclaw/blob/2c743d31/.github/workflows/ci.yml#L82-L99)

### 4. Docker

Official images are hosted on GitHub Container Registry (`ghcr.io`).

```

```

**Running in Gateway Mode:**

```

```

Sources: [README.md91-92](https://github.com/qhkm/zeptoclaw/blob/2c743d31/README.md?plain=1#L91-L92) [landing/zeptoclaw/docs/src/content/docs/getting-started/installation.md38-53](https://github.com/qhkm/zeptoclaw/blob/2c743d31/landing/zeptoclaw/docs/src/content/docs/getting-started/installation.md?plain=1#L38-L53)

## Technical Implementation: Build and Verification

The following diagram maps the installation and verification logic to specific code entities and CI workflows.

### Installation & CI Data Flow

```

```

**Diagram: Release to Diagnostic Flow**

Sources: [.github/workflows/release.yml11-66](https://github.com/qhkm/zeptoclaw/blob/2c743d31/.github/workflows/release.yml#L11-L66) [install.sh9-85](https://github.com/qhkm/zeptoclaw/blob/2c743d31/install.sh#L9-L85) [CHANGELOG.md79](https://github.com/qhkm/zeptoclaw/blob/2c743d31/CHANGELOG.md?plain=1#L79-L79)

## Post-Installation Verification

### System Diagnostics ( doctor )

After installation, run the `doctor` command to ensure the environment is correctly configured for agent execution.

```

```

The `doctor` command executes several critical checks, including binary detection for tools and configuration integrity [CHANGELOG.md79](https://github.com/qhkm/zeptoclaw/blob/2c743d31/CHANGELOG.md?plain=1#L79-L79)

### Code Entity Mapping: Diagnostics

```

```

**Diagram: Code entities involved inzeptoclaw doctorand Health Monitoring**

Sources: [CHANGELOG.md58-63](https://github.com/qhkm/zeptoclaw/blob/2c743d31/CHANGELOG.md?plain=1#L58-L63) [CHANGELOG.md79](https://github.com/qhkm/zeptoclaw/blob/2c743d31/CHANGELOG.md?plain=1#L79-L79)

## Uninstallation

To completely remove ZeptoClaw and its associated state (history, memory, configuration):

```

```

For package-managed installs:

```

```

Sources: [README.md101-113](https://github.com/qhkm/zeptoclaw/blob/2c743d31/README.md?plain=1#L101-L113) [landing/zeptoclaw/docs/src/content/docs/getting-started/installation.md98-114](https://github.com/qhkm/zeptoclaw/blob/2c743d31/landing/zeptoclaw/docs/src/content/docs/getting-started/installation.md?plain=1#L98-L114)
