agent-zero

agent0ai/agent-zero

Agent Zero AI framework

18k
Stars
3.7k
Forks
254
Open issues
288
Watchers
Python OtherLast pushed Jul 6, 2026

Overview

An open, dynamic agentic framework shipped in a Docker container featuring a full Linux system and desktop environment for extending functionality with Skills.

Categories

Tags

Relationships

Similar tools

Install

pip install agent-zero

README

Agent Zero

A full Linux system for your AI agent.

Agent Zero is an open, dynamic, organic agentic framework. One Docker container ships a full Linux system with a desktop and a plugin hub that the agent can extend using Skills.

Install | Launcher | What's Different | A0 CLI | Docs

Ask ChatGPT | Ask Claude

How To Install

Choose the install path that matches your machine.

PathBest forWhat it does
A0 LauncherDesktop users who want the guided pathDownloads Agent Zero, creates and manages local Instances, and helps set up the container runtime when needed.
A0 InstallTerminals, SSH sessions, servers, and scripted setupInstalls Agent Zero from the command line, reuses an existing Docker-compatible runtime first, and can run headlessly.
DockerMachines that already have Docker readyRuns the Agent Zero container directly.

A0 Launcher

The desktop A0 Launcher is the recommended way to install Agent Zero on a personal machine. Download the Launcher, open it, and let it check your local runtime. If Docker is missing or stopped, the Launcher offers a setup path before it downloads Agent Zero. If you already host Agent Zero elsewhere, add it as a remote Instance and use the Launcher without local Docker setup.

Downloads

ArchitecturemacOSLinuxWindows
x86Mac IntelLinux x86Windows x86
ARM64Mac Apple SiliconLinux ARM64Windows ARM64

See the A0 Launcher v1.2 release for release notes and updater metadata. See the Launcher guide for the first-run walkthrough.

A0 Install

Use A0 Install when you want the terminal path: SSH sessions, servers, recovery shells, or a scriptable setup. It creates Dockerized Agent Zero instances, mounts each instance's data into /a0/usr inside the container, and uses a reuse-before-setup policy: it tries your current Docker CLI configuration, DOCKER_HOST, Docker contexts, and known local Docker-compatible endpoints before setting up a runtime.

macOS / Linux

curl -fsSL https://bash.agent-zero.ai | bash

Windows PowerShell

irm https://ps.agent-zero.ai | iex

Headless / scripted

For servers and automation, run the installer in Quick Start mode so it creates one instance and exits without opening menus:

curl -fsSL https://bash.agent-zero.ai | bash -s -- --quick-start --name agent-zero --port 5080
& ([scriptblock]::Create((irm https://ps.agent-zero.ai))) -QuickStart -Name agent-zero -Port 5080

Use --skip-runtime-setup / -SkipRuntimeSetup when Docker mus