agent0ai/agent-zero

Agent Zero Give your agent a full Linux computer. Agent Zero is an open agent framework for work that needs more than chat: a Dockerized Linux desktop, a browser with DOM annotation, live document cowork, projects, skills, plugins, and a bridge back to your host machine. Quick Start | Why Agent Zero | Try These First | Deep Dives | Docs Why Agent Zero Feature Why it matters Full Linux desktop The agent can use real GUI software, terminals, files, and desktop apps inside the Canvas. Browser DOM annotation Click page elements and turn them into inspect, change, lift, or review instructions. Live document cowork Edit Markdown, Writer, Spreadsheet, and Presentation files together instead of losing work in chat. Plugin Hub Install 100+ community plugins or publish your own extension points. Projects and memory Keep files, instructions, secrets, memories, repositories, and model-preset choices isolated per project. Host-machine bridge Connect with the A0 CLI so the same agent can work in your real local repositories. Multi-agent cooperation Let agents delegate research, coding, analysis, or review tasks to focused subagents. Transparent internals Prompts, tools, plugins, skills, and settings are inspectable and editable. Quick Start Recommended: A0 Launcher The desktop A0 Launcher is the fastest guided path on a personal machine. Download it, open it, and let it check Docker, create Instances, manage ports, and connect to local or remote Agent Zero installs. Agent Zero runs wherever Docker runs, from a $6 VPS or Raspberry Pi to a local workstation or GPU server. Architecture macOS Linux Windows x86 Mac Intel Linux x86 Windows x86 ARM64 Mac Apple Silicon Linux ARM64 Windows ARM64 See the A0 Launcher v1.8 release for release notes and updater metadata. See the Launcher guide for the first-run walkthrough. Other install paths 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 must already be working and the installer should not try to set up a runtime. See the A0 Install repository for all installer flags. Docker already installed? Run this directly docker run -p 80:80 -v a0_usr:/a0/usr agent0ai/agent-zero 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 . Troubleshooting Docker is not running: start Docker Desktop or your Docker service, then reopen the Launcher or rerun the install command. Port 80 is already in use: use the Launcher to pick another port, or run Docker directly with -p 5080:80 and open http://localhost:5080 . Installing on a server: use the A0 Install Quick Start command with --quick-start --name agent-zero --port 5080 . Still blocked: see the Troubleshooting guide . Try These First Annotate a design you like: "Open this template site in the Browser. I'll annotate the hero section - re-implement it in my project's React + Tailwind stack." Cowork on a spreadsheet: "Create an editable ODS budget model with assumptions and monthly projections." Drive a desktop app: "Use the Linux Desktop to open Blender and create a simple 3D logo for me." Review a web UI: "Open my local app in the Browser. I will annotate the page with comments; then implement the requested UI fixes." Create a specialist: "Create an Agent Profile for financial analysis with cautious reasoning, clear assumptions, and spreadsheet-first deliverables." Recover a workspace: "Show me recent Time Travel snapshots and explain what changed before I revert anything." Deep Dives A Real Linux Desktop in the Canvas Agent Zero opens its own Linux desktop inside the right-side Canvas. Not a remote VM, not a shared clipboard, but a real XFCE desktop session running in the container. That means the agent can drive real desktop software : open Blender to model a 3D object, jump into a terminal window, manage files visually, run a GUI tool that has no API. You watch every action, and you can intervene at any moment because your mouse and keyboard share the same desktop. See the Desktop guide for the walkthrough, prompt examples, and how Desktop differs from Browser. Native Browser With DOM Annotations Agent Zero ships a built-in Browser with an optional live surface in the Canvas. The agent can open pages, read them, click, type, upload files, and take screenshots - the usual. The unusual part is Annotate mode . Annotate mode turns any webpage into an interactive directive surface. Click an element to: Change it - "make this button blue and round the corners" runs as a JS instruction the agent applies and verifies. Inspect it - pull the DOM, the styles, the parent chain, the framework hints into the conversation. Lift it - see a card, hero, or component on someone else's site that you like? Capture it and have the agent re-implement it in your own project's stack. Comment it - leave actionable notes pinned to elements during a UI review; the agent reads the comments and ships the fixes. The Docker browser is the default live Browser surface. Browser history keeps screenshots of important steps, so older chats can still show what the agent saw. The Browser also supports Chrome extensions inside the Docker browser, and Bring Your Own Browser through the A0 CLI Connector lets the agent drive Chrome, Edge, Brave, Opera, Vivaldi, or Chromium on your own machine. See the Browser guide for screenshots, settings, host-browser setup, and troubleshooting. Cowork on Documents Markdown Editor With Live Cowork The Canvas includes a rich Markdown editor designed for genuine cowork. Ask the agent to "write a plan to do X in a TODO.md in the open doc" and you'll see the file appear in the editor, character by character, while you keep typing in another section. It's not a preview pane. It's a real editor with toolbar, formatting buttons, tables, and an editable source view - built so that the agent's edits and yours are equal first-class operations on the same document. Use it for plans, TODOs, meeting notes, RFCs, project handoffs, or any artifact where the deliverable should live as text rather than be trapped inside chat scrollback. LibreOffice Integration LibreOffice Writer, Calc, and Impress are wired up so you can type by hand while Agent Zero creates, updates, saves, and verifies the same files in real time. ODT, ODS, and ODP binary formats are first-class citizens in the Agent Zero Desktop environment to align with the Open Document Format (ODF). Use the Desktop toolbar to create and edit Writer, Spreadsheet, and Presentation LibreOffice files. Plugin Hub - 100+ Community Plugins Agent Zero is built for extension, not just configuration. The built-in Plugin Hub browses a growing catalog of community plugins - currently more than 100, covering: Development frameworks like the BMAD Method (full software development lifecycle with 20 specialist agents) and Agent Skills . Memory systems - alternative memory backends, intelligent consolidation strategies, vector recall plugins. Tools and integrations - embedded terminals, custom browsers, deployment helpers, API clients.