agent0ai/agent-zero
Agent Zero AI framework
Agent Zero – an open‑source AI‑agent workbench
What it is – Agent Zero is a Docker‑based framework that gives a language‑model‑driven agent a full Linux desktop to work in. The agent can drive GUI applications, a built‑in browser, LibreOffice editors, and a terminal, while you watch and intervene through a web UI called the Canvas.
Key components
- Linux desktop (XFCE) inside the container – the agent can open any GUI program (e.g., Blender, VS Code, terminal) and manipulate files just like a human user.
- Browser with DOM annotation – click elements to inspect, modify, “lift” (capture) components, or leave comments that the agent can act on.
- Live document coworking – Markdown, ODT/ODS/ODP editors are shared between you and the agent in real time.
- Plugin Hub – >100 community plugins for skills, memory back‑ends, development frameworks, UI tweaks, etc.
- Projects & memory – isolated workspaces that keep files, secrets, Git repos, and model presets separate per task.
- A0 CLI connector – a thin client that bridges the Dockerised agent to your host machine, letting the same agent edit local repositories or run host‑side tools.
- Multi‑agent cooperation – an agent can spawn sub‑agents to specialize (research, coding, analysis) and aggregate their results.
- Time‑Travel snapshots – automatic versioning of the
/a0/usrworkspace for easy diff/rollback (supplementary to Git).
Installation
- A0 Launcher (GUI) – download a platform‑specific binary (macOS, Linux, Windows) that handles Docker checks, instance creation, and port management.
- A0 Install (scripted) – one‑line curl/PowerShell command that sets up a Docker container and optionally runs in quick‑start mode.
- Direct Docker run –
docker run -p 80:80 -v a0_usr:/a0/usr agent0ai/agent-zerofor manual control.
Typical workflow
- Start an instance via the Launcher or script.
- Open the web UI, configure an LLM provider (OpenAI Codex, Gemini, Claude, etc.).
- Create a Project (optionally clone a Git repo). The agent now has its own isolated filesystem.
- Ask the agent to perform a task – e.g., “design a 3‑D logo in Blender”, “annotate this web page and re‑implement the hero component in React”, or “build a budget spreadsheet”.
- Watch the agent act in the Canvas desktop or browser; intervene by typing, clicking, or editing files directly.
- Use plugins or custom skills to extend functionality, or spawn sub‑agents for larger jobs.
- When finished, snapshot the workspace or revert via Time Travel.
Use‑case highlights
- Software engineering – the agent can open a codebase, run tests, edit files, and commit changes while you supervise.
- Design & UI iteration – browse competitor sites, annotate elements, and have the agent generate matching components.
- Financial analysis – collect data, build ODS spreadsheets, and produce editable charts.
- Document production – co‑author Markdown, ODT, or presentation files without leaving the chat.
- Automation & orchestration – schedule recurring checks, run CLI tools on the host via the A0 connector, or chain multiple specialized sub‑agents.
Safety notes
- Run inside Docker (or another container) to isolate the agent.
- Limit host‑directory mounts; grant read/write only where needed.
- Store credentials in project secrets, not in prompts.
- Review any actions that affect production systems, money, or private data.
Where to learn more
- Full docs:
./docs/(quick‑start, browser guide, desktop guide, plugins, memory, MCP, etc.) - Community: Discord, YouTube channel, Skool community, and GitHub Issues.
- Open‑source code and plugin hub are on GitHub under the
agent0aiorganization.
Bottom line – Agent Zero is a comprehensive, extensible platform that lets LLM agents operate in a real Linux desktop environment, bridging the gap between pure text‑only chat and hands‑on software development, design, and data work.
Related
- Project
- Dispatch
- Project
- Project
- Project