a999ed02 · samitouri/QOSami_Agents_Zero

@@ -3,24 +3,18 @@

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

4

5 # Agent Zero

6 -### AI agents with a full Linux system at their fingertips.

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

7

8 -Agent Zero is a dynamic, organic agentic framework for running AI agents that can create tools, write code, browse the web, cooperate with other agents, and keep learning from your goals and projects.

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.

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 -[Introduction](#what-is-agent-zero) |

16 -[Space Agent](#agent-zero-and-space-agent) |

17 -[Quick Start](#how-to-install) |

18 -[LLM Plans](#use-your-openai-codex-plan) |

19 -[CLI Connector](#a0-cli-connector-use-agent-zero-on-your-host-machine) |

20 -[Browser](#native-browser-with-annotations-and-extensions) |

21 -[Desktop](#linux-desktop-and-libreoffice-cowork) |

22 -[Features](#what-makes-agent-zero-different) |

23 -[Examples](#try-these-first) |

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

16 +[What's Different](#what-makes-agent-zero-different) |

17 +[A0 CLI](#a0-cli-connector-extend-onto-your-host-machine) |

18 [Docs](#documentation)

19

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

@@ -36,14 +30,6 @@ Agent Zero is a dynamic, organic agentic framework for running AI agents that ca

30 </a>

31 </div>

32

39 -# What Is Agent Zero

40 -

41 -Agent Zero is not a predefined one-purpose agent.

42 -

43 -It is a transparent, extensible framework where the agent can use the operating system as a tool: a real Linux environment, terminal, code execution, files, memory, browser automation, plugins, and tools it learns to create along the way.

44 -

45 -The goal is simple: give an AI agent enough environment, memory, communication, and freedom to solve real tasks while keeping the work inspectable and steerable by you.

46 -

33 ## How To Install

34

35 ### macOS / Linux

@@ -58,89 +44,102 @@ curl -fsSL https://bash.agent-zero.ai | bash

44 irm https://ps.agent-zero.ai | iex

45 ```

46

61 -### Docker Desktop already installed? Use this command directly

47 +### Docker already installed? Run this directly

48

49 ```bash

50 docker run -p 80:80 -v a0_usr:/a0/usr agent0ai/agent-zero

51 ```

52

67 -Then open the Web UI, configure your LLM provider, and start with a concrete task. For the full setup path, including updates and platform notes, see the [Installation guide](./docs/setup/installation.md).

53 +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).

54

55 # What Makes Agent Zero Different

56

71 -## Computer as a Tool

57 +## A Real Linux Desktop in the Canvas

58

73 -Agent Zero can use a Kali Linux system to accomplish your task. It can inspect files, run commands, write code, install and use tools, create scripts, search the web, and adapt its workflow as the task evolves.

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

60 +

61

75 -The important idea is not a fixed list of buttons. The important idea is that the agent can build and use the right tool when the work demands it.

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

63

77 -## Canvas

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

65

79 -Agent Zero is becoming more visual and shared. The right-side Canvas gives agents and humans working surfaces for browser sessions, documents, workspace history, and other plugin panels.

66 +You watch every action, and you can intervene at any moment because your mouse and keyboard share the same desktop.

67

81 -The Canvas makes agent work visible. You can watch it browse, inspect what changed, open files, cowork on deliverables, and intervene before a small mistake becomes a large one.

68 +See the [Desktop guide](./docs/guides/desktop.md) for the walkthrough, prompt examples, and how Desktop differs from Browser.

69

83 -## Linux Desktop and LibreOffice Cowork

70 +## Native Browser With DOM Annotations

71

85 -<img alt="Agent Zero Desktop Canvas" src="docs/res/usage/webui/desktop-canvas.png" />

72 +<img alt="Annotating a webpage element in the Agent Zero browser" src="docs/res/usage/browser/annotation.gif" />

73

74

88 -The Desktop surface opens Agent Zero's own Linux desktop in the Canvas. It is useful when the work needs a real GUI: Linux desktop apps, a terminal window, visual file management, or LibreOffice running where you and the agent can both see it.

89 -

90 -<img alt="Cowork on Documents" width="1406" height="720" src="https://github.com/user-attachments/assets/4ad71888-4f0d-484a-b68b-631ad99187d7" />

91 -

75 +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**.

76

93 -Create, open, and cowork with the AI on documents, spreadsheets, and presentation decks with the LibreOffice stack.

77 +Annotate mode turns any webpage into an interactive directive surface. Click an element to:

78

95 -The Desktop toolbar can create Markdown, Writer, Spreadsheet, and Presentation files. LibreOffice Writer, Calc, and Impress run inside the Desktop, so you can type by hand while Agent Zero creates, updates, saves, and verifies the same files.

79 +- **Change it** - "make this button blue and round the corners" runs as a JS instruction the agent applies and verifies.

80 +- **Inspect it** - pull the DOM, the styles, the parent chain, the framework hints into the conversation.

81 +- **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.

82 +- **Comment it** - leave actionable notes pinned to elements during a UI review; the agent reads the comments and ships the fixes.

83

97 -The document Canvas supports Markdown by default, with LibreOffice-native ODT, ODS, and ODP workflows when binary office artifacts are needed. Microsoft Office compatibility imports and exports remain available when explicitly requested.

84 +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/Chromium on your own machine.

85

99 -Markdown, Writer, Spreadsheet, and Presentation files share a compact active-file header with save, rename, close, and creation controls in both Canvas and modal views.

86 +See the [Browser guide](./docs/guides/browser.md) for screenshots, settings, host-browser setup, and troubleshooting.

87

101 -See the [Desktop guide](./docs/guides/desktop.md) for the screenshot walkthrough, prompt examples, and how Desktop differs from Browser.

88 +## Cowork on Documents

89

103 -## Native Browser With Annotations and Extensions

90 +### Markdown Editor With Live Cowork

91

105 -<img alt="Agent Zero Browser Canvas and tool history" src="docs/res/usage/browser/browser-canvas-wide.png" />

92 +<img alt="Agent Zero writing a TODO plan in the Canvas markdown editor" src="docs/res/usage/webui/markdown-editor.gif" />

93

94

108 -Agent Zero includes 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.

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

96

110 -The Docker browser is the default live Browser surface. With A0 CLI, Agent Zero can also use **Bring Your Own Browser** to work with Chrome, Edge, or Chromium on your own computer. Open the Browser surface when you want to watch the Docker browser, or ask Agent Zero to show it in the Canvas.

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

98

112 -Browser history keeps screenshots of important steps, so older chats can still show what the agent saw.

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

100

114 -For web and mobile development, Annotate mode lets you click page elements or regions and leave actionable comments for the agent targeted at the page itself. You can review a UI visually, mark what needs to change, and send those notes straight back into the conversation.

101 +### LibreOffice Integration

102

116 -The Browser also supports Chrome extensions inside the Docker browser. See the [Browser guide](./docs/guides/browser.md) for screenshots, settings, host-browser setup, and troubleshooting.

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

104

118 -## Use Your OpenAI Codex Plan

105 +ODT, ODS, and ODP binary formats are first-class citizens in the Agent Zero Desktop environment to align with the Open Document Format (ODF).

106

120 -Agent Zero can now connect to your OpenAI Codex plan through the new OAuth flow. Sign in with your account, pick the Codex-backed provider, and let Agent Zero use the plan you already have.

107 +Use the Desktop toolbar to create and edit Writer, Spreadsheet, and Presentation LibreOffice files.

108

122 -<img alt="OAuth LLM plans in Agent Zero" src="docs/res/codex-screenshot.png" />

109 +## Plugin Hub - 100+ Community Plugins

110 +

111 +<img alt="Agent Zero Plugin Hub showing community plugins" src="docs/res/usage/plugins/plugin-hub-browse.png" />

112

113

125 -Click "Connect", enter the device code in the OpenAI page. Choose your model after checking the list, and you're all set.

114 +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:

115

127 -This is the first step toward account-backed LLM plans in Agent Zero. More integrations are coming, including Gemini CLI, Claude Code based on extra-usage, and more.

116 +- **Development frameworks** like the [BMAD Method](https://github.com/bmad-code-org/bmad-method) (full software development lifecycle with 20 specialist agents) and [Agent Skills](https://github.com/addyosmani/agent-skills).

117 +- **Memory systems** - alternative memory backends, intelligent consolidation strategies, vector recall plugins.

118 +- **Tools and integrations** - embedded terminals, custom browsers, deployment helpers, API clients.

119 +- **UI extensions** - chat rename controls, sidebar tweaks, theme packs, custom Canvas panels.

120 +- **Workflow plugins** - schedulers, multi-agent orchestration, project automations.

121

129 -# A0 CLI Connector: Use Agent Zero on Your Host Machine

122 +Install with a click from the Web UI, or publish your own to the index repository. Combined with custom prompts in `prompts/`, custom tools in `tools/`, MCP servers, A2A connectors, and project-scoped configuration, Agent Zero gives you a real surface area to shape the agent into whatever you need.

123

131 -The **A0 CLI Connector** is not a separate CLI agent. It connects to a running

132 -Agent Zero instance and gives that instance a terminal-native bridge to your

133 -host machine.

124 +See the [Skills guide](./docs/guides/skills.md), the [Create a Small Plugin](./docs/guides/create-plugin.md) tutorial, and the [MCP setup](./docs/guides/mcp-setup.md) guide.

125

135 -Agent Zero stays responsible for the reasoning loop, memory, projects, profiles,

136 -model choices, and tools. The CLI is how you intentionally let that Agent

137 -Zero instance work beyond the Docker container: on your host machine, in a

138 -terminal-first workflow, or against a server where you do not want a GUI at all.

126 +## Use Your OpenAI Codex Plan

127

140 -<img alt="A0 CLI Connector connected shell" src="docs/res/usage/a0-cli/a0-cli-start.png" />

128 +<img alt="OAuth LLM plans in Agent Zero" src="docs/res/codex-screenshot.png" />

129

130

143 -Install the connector on the machine you want Agent Zero to work on, not inside the Agent Zero container.

131 +Agent Zero connects to your OpenAI Codex plan through the new OAuth flow. Sign in with your account, pick the Codex-backed provider, and let Agent Zero use the plan you already have. Click "Connect", enter the device code in the OpenAI page, choose your model, and you're set.

132 +

133 +This is the first step toward account-backed LLM plans in Agent Zero. More integrations are coming, including Gemini CLI and Claude Code through extra-usage.

134 +

135 +## A0 CLI Connector: Extend Onto Your Host Machine

136 +

137 +<img alt="A0 CLI driving the host browser through a Google Cloud VM creation flow" src="docs/res/usage/a0-cli/host-browser.gif" />

138 +

139 +

140 +The **A0 CLI Connector** is not a separate CLI agent. It connects to a running Agent Zero instance and gives that instance a terminal-native bridge to your host machine - so the same agent (with all its memory, projects, and skills) can also work on real files outside the Docker container.

141 +

142 +Install the connector on the machine you want Agent Zero to work on, **not** inside the Agent Zero container.

143

144 ### macOS / Linux

145

@@ -154,64 +153,45 @@ curl -LsSf https://cli.agent-zero.ai/install.sh | sh

153 irm https://cli.agent-zero.ai/install.ps1 | iex

154 ```

155

157 -Then run:

158 -

159 -```bash

160 -a0

161 -```

162 -

163 -`a0` connects your terminal to an existing Agent Zero instance. It can usually discover a local instance automatically, or you can point it at a remote Agent Zero URL hosted somewhere else, such as a VPS or tunnel.

164 -

165 -Inside the shell, use `Ctrl+P` for the command palette, `/chats` to switch work, `/models` or `/presets` to adjust models, and `/browser status` to check Browser mode.

166 -

167 -When you activate **Read+Write** access and the **Remote Code Execution Tool** in the CLI, Agent Zero can operate on the filesystem and shell of the machine where `a0` is running. That means it can work on your real local project files, not only files inside the Docker sandbox.

156 +Then run `a0` to connect your terminal to an existing Agent Zero instance. It can usually discover a local instance automatically, or you can point it at a remote URL hosted somewhere else, such as a VPS or tunnel.

157

158 This is especially useful if you:

159

160 - prefer CLI workflows;

161 - want Agent Zero to work in an existing local repository;

162 - are running Agent Zero on a remote server;

174 -- need code execution on a headless machine without using the Web UI;

175 -- want Docker isolation for Agent Zero while still granting explicit, controlled access to selected host-side work.

163 +- want Docker isolation for Agent Zero while still granting explicit, controlled access to host-side work.

164

177 -For full setup details, manual fallback installation, and remote-host tips, see the [A0 CLI Connector guide](./docs/guides/a0-cli-connector.md).

165 +For full setup, see the [A0 CLI Connector guide](https://www.agent-zero.ai/p/docs/a0-cli-connector/) (or the [in-repo guide](./docs/guides/a0-cli-connector.md)).

166

167 +## Projects, Skills, Agent Profiles, and Model Presets

168

180 -### Projects, Skills, Agent Profiles, and Model Presets

169 +**Projects** isolate workspaces, instructions, memory, secrets, knowledge, repositories, and model presets. Clone a public or private Git repo into a project and give the agent context that belongs to that work alone.

170

182 -Projects isolate workspaces, instructions, memory, secrets, knowledge, repositories, and model presets. Clone a public or private Git repo into an isolated project and give the agent context that belongs to that work alone.

171 +**Skills** can be loaded on demand by Agent Zero, or pinned from the chat input when you want a specific procedure to stay active.

172

184 -Skills can be loaded on demand by Agent Zero, or pinned from the chat input when

185 -you want a specific procedure to stay active. Agent Profiles change the broader

186 -working style of the current chat. Model Presets are named shortcuts for model

187 -setups, so users can quickly switch between fast, balanced, cheap, local, or

188 -high-power model choices.

173 +**Agent Profiles** change the broader working style of the current chat.

174

190 -### Multi-Agent Cooperation

175 +**Model Presets** are named shortcuts for model setups, so you can quickly switch between fast, balanced, cheap, local, or high-power model choices.

176 +

177 +## Multi-Agent Cooperation

178

179 Every agent can create subordinate agents to break down work. The superior gives tasks and receives reports; subagents keep their own contexts focused and return their findings when done.

180

181 This makes Agent Zero useful for research, software engineering, data analysis, plugin development, and tasks where several specialized perspectives are better than one overloaded context.

182

196 -### Transparent and Extensible by Design

183 +## Transparent and Extensible by Design

184

185 Almost nothing is hidden. Prompts live in `prompts/`, tools live in `tools/` or plugins, and built-in behavior can be inspected, changed, replaced, or extended.

186

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

188

202 -### Also Included

203 -

204 -- Fully Dockerized runtime with a clean Web UI.

205 -- Real-time streamed output so you can interrupt, redirect, or refine the work as it happens.

206 -- Speech-to-text and text-to-speech support through the built-in `_kokoro_tts` and `_whisper_stt` plugins, with browser-native speech synthesis as the fallback output path.

207 -- Chat load/save, generated HTML logs, file browser, settings UI, and deployment-friendly `A0_SET_` configuration.

208 -

189 ## Try These First

190

211 -- **Research with the Browser tool:** "Use the Browser tool to compare three project management tools for a small AI team, and summarize the tradeoffs with source links."

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

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

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

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

214 -- **Work inside a Git project:** "Clone this repository into a new project, understand the layout, and propose the safest first improvement."

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

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

197

@@ -239,7 +219,8 @@ It is not a replacement for Git or backups. It is a practical safety layer for t

219 ## Real-World Use Cases

220

221 - **Software engineering:** inspect a codebase, make scoped edits, run tests, explain tradeoffs, and keep a recoverable history of file changes.

242 -- **Host-machine development:** connect with `a0`, grant Read+Write and remote execution when needed, and let Agent Zero work in your real local repositories.

222 +- **Host-machine development:** connect with `a0` and let Agent Zero work in your real local repositories, or clone them through Git Projects feature in the Web UI.

223 +- **Design inspiration and UI iteration:** browse the web, annotate elements you like, and pull components into your own stack.

224 - **Financial analysis and charting:** collect data, correlate events, create spreadsheets, and generate editable charts.

225 - **Office deliverables:** cowork on documents, spreadsheets, and presentation decks instead of trapping the result in chat text.

226 - **Web and mobile QA:** browse an app, annotate UI issues, install browser extensions, and turn visual comments into actionable fixes.

@@ -249,7 +230,7 @@ It is not a replacement for Git or backups. It is a practical safety layer for t

230

231 ## Safety Model

232

252 -Agent Zero is powerful because it can use a real environment. Treat it with the same respect you would give a capable developer with shell access.

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

234

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

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

@@ -257,7 +238,6 @@ Agent Zero is powerful because it can use a real environment. Treat it with the

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

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

240 - Keep backups for important workspaces.

260 -- Install browser extensions and third-party plugins only from sources you trust.

241

242 ## Documentation

243

@@ -267,7 +247,7 @@ Agent Zero is powerful because it can use a real environment. Treat it with the

247 | Learn the UI and basic workflow | [Quickstart](./docs/quickstart.md) |

248 | Browse, annotate, and use Browser screenshots | [Browser guide](./docs/guides/browser.md) |

249 | Use the Linux desktop and LibreOffice | [Desktop guide](./docs/guides/desktop.md) |

270 -| Connect Agent Zero to host-machine files and shell | [A0 CLI Connector](./docs/guides/a0-cli-connector.md) |

250 +| Connect Agent Zero to host-machine files and shell | [A0 CLI Connector](https://www.agent-zero.ai/p/docs/a0-cli-connector/) |

251 | Use projects and Git workspaces | [Projects guide](./docs/guides/projects.md) |

252 | Create a small plugin | [Create a Small Plugin](./docs/guides/create-plugin.md) |

253 | Add or remove active skills | [Skills guide](./docs/guides/skills.md) |

@@ -285,7 +265,7 @@ Agent Zero is powerful because it can use a real environment. Treat it with the

265

266 Agent Zero is built for people who want to understand and shape their tools.

267

288 -You can help by improving docs, creating skills, publishing plugins, testing model/provider setups, reporting bugs, sharing workflows, or contributing core improvements. Start with the [Contributing guide](./docs/guides/contribution.md), browse the [Plugin Hub](./docs/guides/usage.md), or bring ideas to Discord.

268 +You can help by improving docs, creating skills, publishing plugins, testing model/provider setups, reporting bugs, sharing workflows, or contributing core improvements. Start with the [Contributing guide](./docs/guides/contribution.md), browse the [Plugin Hub](https://www.agent-zero.ai/p/docs/plugins/#plugin-hub), or bring ideas to Discord.

269

270 ## Community and Support

271

Refresh README showcase assets