Update README install options
Move installation guidance out of the feature overview and split it into Launcher, A0 Install, and direct Docker paths. Add the A0 Launcher v0.9 download matrix, document headless A0 Install usage, and keep the visible architecture labels aligned with the requested x86/ARM wording.
Alessandro committed
Jun 24, 2026 at 13:06 UTC
ac1051b511ab32876e1d2eaa69fc287fe39abd45
1 file changed
+39
-8
README.md
+39
-8
@@ -13,7 +13,7 @@ Agent Zero is an open, dynamic, organic agentic framework. One Docker container
13
[](https://github.com/sponsors/agent0ai)
14
15
[Install](#how-to-install) |
16
-[Launcher](#agent-zero-launcher) |
16
+[Launcher](#a0-launcher) |
17
[What's Different](#what-makes-agent-zero-different) |
18
[A0 CLI](#a0-cli-connector-extend-onto-your-host-machine) |
19
[Docs](#documentation)
@@ -31,17 +31,32 @@ Agent Zero is an open, dynamic, organic agentic framework. One Docker container
31
</a>
32
</div>
33
34
-# What Makes Agent Zero Different
34
+# How To Install
35
+
36
+Choose the install path that matches your machine.
37
+
38
+| Path | Best for | What it does |
39
+| --- | --- | --- |
40
+| **A0 Launcher** | Desktop users who want the guided path | Downloads Agent Zero, creates and manages local Instances, and helps set up the container runtime when needed. |
41
+| **A0 Install** | Terminals, SSH sessions, servers, and scripted setup | Installs Agent Zero from the command line, reuses an existing Docker-compatible runtime first, and can run headlessly. |
42
+| **Docker** | Machines that already have Docker ready | Runs the Agent Zero container directly. |
43
+
44
+## A0 Launcher
45
36
-## How To Install
46
+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.
47
38
-### Agent Zero Launcher
48
+### Downloads
49
40
-Starting fresh on a new machine? Use the desktop **Agent Zero Launcher** if you want a guided app instead of manual Docker commands.
50
+| Architecture | macOS | Linux | Windows |
51
+| --- | --- | --- | --- |
52
+| x86 | [Mac Intel](https://github.com/agent0ai/a0-launcher/releases/download/v0.9/a0-launcher-0.9-macos-x64.dmg) | [Linux x86](https://github.com/agent0ai/a0-launcher/releases/download/v0.9/a0-launcher-0.9-linux-x64.AppImage) | [Windows x86](https://github.com/agent0ai/a0-launcher/releases/download/v0.9/a0-launcher-0.9-windows-x64.exe) |
53
+| ARM64 | [Mac Apple Silicon](https://github.com/agent0ai/a0-launcher/releases/download/v0.9/a0-launcher-0.9-macos-arm64.dmg) | [Linux ARM64](https://github.com/agent0ai/a0-launcher/releases/download/v0.9/a0-launcher-0.9-linux-arm64.AppImage) | [Windows ARM64](https://github.com/agent0ai/a0-launcher/releases/download/v0.9/a0-launcher-0.9-windows-arm64.exe) |
54
42
-Download the Launcher from the [A0 Launcher releases](https://github.com/agent0ai/a0-launcher/releases), 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.
55
+See the [A0 Launcher v0.9 release](https://github.com/agent0ai/a0-launcher/releases/tag/v0.9) for release notes and updater metadata. See the [Launcher guide](./docs/guides/launcher.md) for the first-run walkthrough.
56
44
-See the [Agent Zero Launcher guide](./docs/guides/launcher.md) for the first-run walkthrough, screenshots, and the Playwright/Electron capture recipe used for documentation.
57
+## A0 Install
58
+
59
+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.
60
61
### macOS / Linux
62
@@ -55,7 +70,21 @@ curl -fsSL https://bash.agent-zero.ai | bash
70
irm https://ps.agent-zero.ai | iex
71
```
72
58
-### Docker already installed? Run this directly
73
+### Headless / scripted
74
+
75
+For servers and automation, run the installer in Quick Start mode so it creates one instance and exits without opening menus:
76
+
77
+```bash
78
+curl -fsSL https://bash.agent-zero.ai | bash -s -- --quick-start --name agent-zero --port 5080
79
+```
80
+
81
+```powershell
82
+& ([scriptblock]::Create((irm https://ps.agent-zero.ai))) -QuickStart -Name agent-zero -Port 5080
83
+```
84
+
85
+Use `--skip-runtime-setup` / `-SkipRuntimeSetup` when Docker must already be working and the installer should not try to set up a runtime. See the [A0 Install repository](https://github.com/agent0ai/a0-install) for all installer flags.
86
+
87
+## Docker already installed? Run this directly
88
89
```bash
90
docker run -p 80:80 -v a0_usr:/a0/usr agent0ai/agent-zero
@@ -63,6 +92,8 @@ docker run -p 80:80 -v a0_usr:/a0/usr agent0ai/agent-zero
92
93
Open the Web UI, configure your LLM provider, and start with a concrete task. For the full setup and onboarding experience, see the [Installation guide](./docs/setup/installation.md).
94
95
+# What Makes Agent Zero Different
96
+
97
## A Real Linux Desktop in the Canvas
98
99
<img alt="Agent Zero driving Blender in its built-in XFCE desktop" src="docs/res/usage/webui/agentzero-xfce-computer.gif" />