Home/Installation

One Command, Ready to Go

The fastest way to install ZAgent ?pick the command for your platform. Binaries are auto-built and signed by SamAI CI on every commit.

All Platforms (recommended) pip
pip install samai-zagent

Cross-platform. Bundles native binaries for Linux, macOS, and Windows (amd64 + arm64). Run with zagent after install.

Linux / macOS / Termux bash
curl -fsSL https://zagent.samai.cc/install.sh | bash
Windows PowerShell
irm https://zagent.samai.cc/install.ps1 | iex
Install a specific version optional
curl -fsSL https://zagent.samai.cc/install.sh | bash -s -- --version 0.28.23

Standalone Downloads

Pre-built binaries for every major desktop platform ?auto-uploaded by SamAI CI after every release. SHA-256 checksums provided.

🪟

Windows

x86_64 (amd64)

?Download .zip

Or in PowerShell:
irm https://zagent.samai.cc/install.ps1 | iex

🪟

Windows

ARM64

?Download .zip

For Surface Pro X / Snapdragon laptops

🐧

Linux

x86_64 (amd64)

?Download .tar.gz

Or one-line:
curl -fsSL https://zagent.samai.cc/install.sh | bash

🐧

Linux

ARM64 (aarch64)

?Download .tar.gz

Raspberry Pi / ARM servers / Termux proot

🍎

macOS

Apple Silicon (arm64)

?Download .tar.gz

M1 / M2 / M3 / M4 Macs

🍎

macOS

Intel (amd64)

?Download .tar.gz

Older Intel-based Macs

🤖

Android

ARM64 APK

?View Releases

Sideload the APK from the public releases repo

View all downloads and SHA-256 checksums ?/a>

Manual Installation

If the one-liner doesn't fit, choose a manual method below.

# One-line install (auto-detects amd64 / arm64)
$ curl -fsSL https://zagent.samai.cc/install.sh | bash

# Or manual download + extract
$ wget https://zagent.samai.cc/downloads/zagent-linux-amd64.tar.gz
$ tar xzf zagent-linux-amd64.tar.gz
$ sudo install -m 0755 zagent /usr/local/bin/

# Launch with Web UI
$ zagent -name ZAgent -code WVJFDK
ZAgent running at http://localhost:8181
# One-line install (Apple Silicon + Intel)
$ curl -fsSL https://zagent.samai.cc/install.sh | bash

# Remove macOS quarantine attribute (if needed)
$ xattr -d com.apple.quarantine /usr/local/bin/zagent

# Launch
$ zagent -name ZAgent -code WVJFDK
ZAgent running at http://localhost:8181
# One-line install in PowerShell (admin or per-user)
> irm https://zagent.samai.cc/install.ps1 | iex

# Or download and extract manually
> Invoke-WebRequest https://zagent.samai.cc/downloads/zagent-windows-amd64.zip -OutFile zagent.zip
> Expand-Archive zagent.zip -DestinationPath "$env:LOCALAPPDATA\zagent"

# Launch
> zagent -name ZAgent -code WVJFDK
ZAgent running at http://localhost:8181
# Run as a daemon (double-fork on Unix, detached on Windows)
$ zagent -name ZAgent -code WVJFDK -daemon -log-file zagent.log

# Headless mode ?no Web UI, no tray icon (for servers)
$ zagent -nowebui -name ZAgent -log-file zagent.log

# All options
$ zagent \
  -code WVJFDK \
  -name "ZAgent" \
  -server "https://aicq.online" \
  -llm-url "https://internal-api.z.ai/v1" \
  -llm-key "Z.ai" \
  -poll 8 \
  -workers 4 \
  -daemon

Ready to Deploy?

Open your terminal and start your AI agent on any platform in under a minute.

View Releases Explore Features Architecture