Agent Zero AI framework
Update README install options
Alessandroac1051b511ab
diff --git a/README.md b/README.mdindex 0cfdbdc28..67d0f1f28 100644--- a/README.md+++ b/README.md@@ -13,7 +13,7 @@ Agent Zero is an open, dynamic, organic agentic framework. One Docker container[](https://github.com/sponsors/agent0ai)[Install](#how-to-install) |-[Launcher](#agent-zero-launcher) |+[Launcher](#a0-launcher) |[What's Different](#what-makes-agent-zero-different) |[A0 CLI](#a0-cli-connector-extend-onto-your-host-machine) |[Docs](#documentation)@@ -31,17 +31,32 @@ Agent Zero is an open, dynamic, organic agentic framework. One Docker container</a></div>-# What Makes Agent Zero Different+# How To Install++Choose the install path that matches your machine.++| Path | Best for | What it does |+| --- | --- | --- |+| **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. |+| **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. |+| **Docker** | Machines that already have Docker ready | Runs the Agent Zero container directly. |++## A0 Launcher-## How To Install+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.-### Agent Zero Launcher+### Downloads-Starting fresh on a new machine? Use the desktop **Agent Zero Launcher** if you want a guided app instead of manual Docker commands.+| Architecture | macOS | Linux | Windows |+| --- | --- | --- | --- |+| 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) |+| 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) |-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.+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.-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.+## 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@@ -55,7 +70,21 @@ curl -fsSL https://bash.agent-zero.ai | bashirm https://ps.agent-zero.ai | iex```-### Docker already installed? Run this directly+### Headless / scripted++For servers and automation, run the installer in Quick Start mode so it creates one instance and exits without opening menus:++```bash+curl -fsSL https://bash.agent-zero.ai | bash -s -- --quick-start --name agent-zero --port 5080+```++```powershell+& ([scriptblock]::Create((irm https://ps.agent-zero.ai))) -QuickStart -Name agent-zero -Port 5080+```++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.++## Docker already installed? Run this directly```bashdocker 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-zeroOpen 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).+# What Makes Agent Zero Different+## A Real Linux Desktop in the Canvas<img alt="Agent Zero driving Blender in its built-in XFCE desktop" src="docs/res/usage/webui/agentzero-xfce-computer.gif" />