3bb40576 · samitouri/QOSami_Agents_Zero-2

@@ -3,49 +3,48 @@

3 <img src="docs/res/a0-vector-graphics/horizontal_banner.svg" alt="Agent Zero Banner" width="100%"/>

4

5 # Agent Zero

6 -### A full Linux system for your AI agent.

6 +### Give your agent a full Linux computer.

7

8 -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.

8 +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.

9

10 [![Website](https://img.shields.io/badge/Website-agent--zero.ai-0A192F?style=for-the-badge&logo=vercel&logoColor=white)](https://agent-zero.ai)

11 [![Docs](https://img.shields.io/badge/Docs-Read%20the%20guides-1F6FEB?style=for-the-badge&logo=readthedocs&logoColor=white)](./docs/)

12 [![Discord](https://img.shields.io/badge/Discord-Join%20us-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/B8KZKNsPpj)

13 [![GitHub Sponsors](https://img.shields.io/badge/Sponsors-Thank%20you-FF69B4?style=for-the-badge&logo=githubsponsors&logoColor=white)](https://github.com/sponsors/agent0ai)

14 -

15 -[Install](#how-to-install) |

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)

20 -

14 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/agent0ai/agent-zero)

22 -[Ask ChatGPT](https://chatgpt.com/?q=Analyze%20this%3A%20https%3A%2F%2Fgithub.com%2Fagent0ai%2Fagent-zero) |

23 -[Ask Claude](https://claude.ai/new?q=Analyze%20this%3A%20https%3A%2F%2Fgithub.com%2Fagent0ai%2Fagent-zero)

15

16 +[Quick Start](#quick-start) |

17 +[Why Agent Zero](#why-agent-zero) |

18 +[Try These First](#try-these-first) |

19 +[Deep Dives](#deep-dives) |

20 +[Docs](#documentation)

21

22 </div>

23

24 <div align="center">

29 -<a href="https://www.youtube.com/watch?v=k78HX_RA9Q0&t=19s">

30 -<img src="docs/res/thumbnail-install.webp" alt="Agent Zero Installation Guide" width="100%"/>

31 -</a>

25 +<img alt="Agent Zero driving Blender in its built-in XFCE desktop" src="docs/res/usage/webui/agentzero-xfce-computer.gif" width="100%" />

26 </div>

27

34 -# How To Install

28 +# Why Agent Zero

29

36 -Choose the install path that matches your machine.

30 +| Feature | Why it matters |

31 +| --- | --- |

32 +| **Full Linux desktop** | The agent can use real GUI software, terminals, files, and desktop apps inside the Canvas. |

33 +| **Browser DOM annotation** | Click page elements and turn them into inspect, change, lift, or review instructions. |

34 +| **Live document cowork** | Edit Markdown, Writer, Spreadsheet, and Presentation files together instead of losing work in chat. |

35 +| **Plugin Hub** | Install 100+ community plugins or publish your own extension points. |

36 +| **Projects and memory** | Keep files, instructions, secrets, memories, repositories, and model presets isolated per project. |

37 +| **Host-machine bridge** | Connect with the A0 CLI so the same agent can work in your real local repositories. |

38 +| **Multi-agent cooperation** | Let agents delegate research, coding, analysis, or review tasks to focused subagents. |

39 +| **Transparent internals** | Prompts, tools, plugins, skills, and settings are inspectable and editable. |

40

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. |

41 +# Quick Start

42

44 -## A0 Launcher

43 +## Recommended: A0 Launcher

44

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.

45 +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.

46

48 -### Downloads

47 +Agent Zero runs wherever Docker runs, from a $6 VPS or Raspberry Pi to a local workstation or GPU server.

48

50 | --- | --- | --- | --- |

@@ -54,6 +53,9 @@ The desktop **A0 Launcher** is the recommended way to install Agent Zero on a pe

53

54 See the [A0 Launcher v1.2 release](https://github.com/agent0ai/a0-launcher/releases/tag/v1.2) for release notes and updater metadata. See the [Launcher guide](./docs/guides/launcher.md) for the first-run walkthrough.

55

56 +<details>

57 +<summary><strong>Other install paths</strong></summary>

58 +

59 ## A0 Install

60

61 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.

@@ -92,12 +94,27 @@ docker run -p 80:80 -v a0_usr:/a0/usr agent0ai/agent-zero

94

95 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).

96

95 -# What Makes Agent Zero Different

97 +</details>

98

97 -## A Real Linux Desktop in the Canvas

99 +## Troubleshooting

100

99 -<img alt="Agent Zero driving Blender in its built-in XFCE desktop" src="docs/res/usage/webui/agentzero-xfce-computer.gif" />

100 -<br>

101 +- **Docker is not running:** start Docker Desktop or your Docker service, then reopen the Launcher or rerun the install command.

102 +- **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`.

103 +- **Installing on a server:** use the A0 Install Quick Start command with `--quick-start --name agent-zero --port 5080`.

104 +- **Still blocked:** see the [Troubleshooting guide](./docs/guides/troubleshooting.md).

105 +

106 +# Try These First

107 +

108 +- **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."

109 +- **Cowork on a spreadsheet:** "Create an editable ODS budget model with assumptions and monthly projections."

110 +- **Drive a desktop app:** "Use the Linux Desktop to open Blender and create a simple 3D logo for me."

111 +- **Review a web UI:** "Open my local app in the Browser. I will annotate the page with comments; then implement the requested UI fixes."

112 +- **Create a specialist:** "Create an Agent Profile for financial analysis with cautious reasoning, clear assumptions, and spreadsheet-first deliverables."

113 +- **Recover a workspace:** "Show me recent Time Travel snapshots and explain what changed before I revert anything."

114 +

115 +# Deep Dives

116 +

117 +## A Real Linux Desktop in the Canvas

118

119 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.

120

@@ -226,31 +243,9 @@ Almost nothing is hidden. Prompts live in `prompts/`, tools live in `tools/` or

243

244 Agent Zero supports plugins, MCP, A2A, custom tools, custom prompts, project-scoped configuration, environment-based deployment settings, and a Web UI designed to keep the agent's work readable in real time.

245

229 -## Try These First

230 -

231 -- **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."

232 -- **Cowork on a spreadsheet:** "Create an editable ODS budget model with assumptions and monthly projections."

233 -- **Drive a desktop app:** "Use the Linux Desktop to open Blender and create a simple 3D logo for me."

234 -- **Review a web UI:** "Open my local app in the Browser. I will annotate the page with comments; then implement the requested UI fixes."

235 -- **Create a specialist:** "Create an Agent Profile for financial analysis with cautious reasoning, clear assumptions, and spreadsheet-first deliverables."

236 -- **Recover a workspace:** "Show me recent Time Travel snapshots and explain what changed before I revert anything."

237 -

238 -## Agent Zero and Space Agent

239 -

240 -Agent Zero is the open framework and Linux-powered agent workbench.

246 +## Time Travel

247

242 -[Space Agent](https://github.com/agent0ai/space-agent) is our newer product direction for the agent-shaped workspace: a Space the agent can reshape from inside your browser, with live demos, a desktop app, and a path to running a real server for yourself or your team.

243 -

244 -<p align="left">

245 - <a href="https://www.youtube.com/watch?v=CNRHxEZ8yqs"><img src="https://github.com/agent0ai/space-agent/raw/main/.github/thumbnail.webp" alt="Watch Space Agent on YouTube" width="560" /></a>

246 -</p>

247 -

248 -If you want the raw power and deep customizability of an agent with a full Linux system, start here with Agent Zero. If you want the polished Space experience for easier personal, team, desktop, or self-hosted use, explore [Space Agent](https://github.com/agent0ai/space-agent).

249 -

250 -

251 -## Time Travel (powered by Space Agent)

252 -

253 -Time Travel gives Agent Zero-owned `/a0/usr` workspaces snapshot history, diff inspection, travel, and revert. It is designed for recoverable agent work: see what changed, compare files, inspect a past state, and roll back when needed. Try it in Space Agent as well (link above).

248 +Time Travel gives Agent Zero-owned `/a0/usr` workspaces snapshot history, diff inspection, travel, and revert. It is designed for recoverable agent work: see what changed, compare files, inspect a past state, and roll back when needed.

249

250 <img alt="Time Travel" src="docs/res/time-travel.png" />

251

@@ -268,17 +263,6 @@ It is not a replacement for Git or backups. It is a practical safety layer for t

263 - **Client/project isolation:** keep memory, secrets, instructions, files, and model choices separated by project.

264 - **Scheduled operations:** run recurring checks and monitoring tasks with project-scoped context and credentials.

265

271 -## Safety Model

272 -

273 -Agent Zero is powerful because it can use a real environment.

274 -

275 -- Keep it running inside Docker or another isolated environment.

276 -- Do not mount your entire home directory unless you understand the risk.

277 -- Grant A0 CLI Read+Write access and remote code execution only for machines and workspaces you trust.

278 -- Store credentials in project secrets or settings, not in prompts or public files.

279 -- Review actions that touch accounts, money, production systems, or private data.

280 -- Keep backups for important workspaces.

281 -

266 ## Documentation

267

268 | I want to... | Start here |

@@ -314,3 +298,16 @@ You can help by improving docs, creating skills, publishing plugins, testing mod

298 - [YouTube](https://www.youtube.com/@AgentZeroFW) for demos and tutorials.

299 - [X](https://x.com/Agent0ai), [LinkedIn](https://www.linkedin.com/company/109758317), and [Warpcast](https://warpcast.com/agent-zero) for updates.

300 - [GitHub Issues](https://github.com/agent0ai/agent-zero/issues) for bugs and feature requests.

301 +

302 +[Space Agent](https://github.com/agent0ai/space-agent) is the related, more polished product direction for the agent-shaped workspace. Agent Zero remains the open framework and Linux-powered workbench.

303 +

304 +## Safety Model

305 +

306 +Agent Zero is powerful because it can use a real environment.

307 +

308 +- Keep it running inside Docker or another isolated environment.

309 +- Do not mount your entire home directory unless you understand the risk.

310 +- Grant A0 CLI Read+Write access and remote code execution only for machines and workspaces you trust.

311 +- Store credentials in project secrets or settings, not in prompts or public files.

312 +- Review actions that touch accounts, money, production systems, or private data.

313 +- Keep backups for important workspaces.

Improve README conversion flow