agent0ai /agent-zero

Agent Zero AI framework

★ 19,867⑂ 3,878👁 287⑃ 1,031● 896▤ 77
PythonNOASSERTIONCreated 2024-06-10agent-zero.ai
下载:v2.15v2.15 ↓2.152026-11-01
+11
日增长
19,867
stars
3,878
forks
287
watchers
1,031
prs
896
issues
77
releases

README

Agent Zero
 Give your agent a full Linux computer.

Agent Zero is an open-source AI agent with its own Linux workspace. It can research, write code, create and work with documents using a terminal, browser, and desktop apps. It runs in a sandbox, but you can step in, and connect it to local files on your own computer when needed.

Get started · Installation guide







Quick Start |
Why Agent Zero |
Try These First |
Deep Dives |
Docs







 Quick Start

Choose A0 Launcher for a desktop computer, or A0 Install for a server or shell-only environment.

You will need a supported AI account, a provider API key, or a local model server to start chatting.



 Desktop setup





A0 Launcher is recommended for desktop computers. It guides you through Docker setup, creates your Agent Zero instance, and opens the Web UI.

Download A0 Launcher v1.9 for your operating system and processor:

| Platform | Recommended download | Other processors |
| --- | --- | --- |
| Windows | Windows x64 · Intel / AMD | Windows ARM64 |
| macOS | Apple Silicon · M-series Macs | Intel Macs only |
| Linux | Linux x64 · Intel / AMD | Linux ARM64 |

1. Open Launcher and follow any Docker setup prompt.
2. Create an Instance, a separate Agent Zero setup. Choose Download Agent Zero or Run Agent Zero, keep the default version and persistent workspace, then click Create. Wait for Running and click Open UI.

Continue with your first message, or see the Installation guide for screenshots and help.



 Servers and shell access

A0 Install is recommended when you have shell access but no graphical desktop, such as a server or an SSH session. It runs interactively in your terminal, helps set up Docker where needed, and creates an Agent Zero instance with a persistent workspace.

 macOS / Linux

bash
curl -fsSL https://bash.agent-zero.ai | bash


 Windows PowerShell

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


Follow the prompts, then open the Web UI and send your first message. For a local install, use the printed URL. On a remote server, localhost refers to that server; follow the VPS guide for access and authentication before connecting from a browser on your own computer.



For setup without installer menus, see scripted installation and the full installer options.

 Send your first message

1. Send a message from the welcome screen. Try: "Create a one-page plan for a 15-minute team kickoff. Save it as a Markdown file and give me a link."
2. Connect a model when the chat asks. Choose Cloud provider, AI account, or Local model, then select a Main model for conversations and a Utility model for summaries and chat names. They can use the same provider.
3. Click Finish setup, then Continue to close setup. Your original message resumes in the same chat; watch for the reply and open the returned file link.

The Codex guide covers ChatGPT account sign-in. If your provider is missing, use the provider-plugin link to find it in the Hub; the OpenCode Go guide walks through installation.


Top issues

Discussions

Latest release

v2.15 v2.15 2026-11-01
Agent Zero — Release Notes

 Highlights

This is a large release that promotes core tools into standalone plugins, overhauls the welcome screen, hardens channel security, improves streaming and UI responsiveness, and adds new search, migration, and documentation capabilities.

---

 Tool Plugin Architecture

- Extracted bundled tools into standalone plugins: wait, notify_user, search_engine, a2a_chat, scheduler, behavior_adjustment, and the scheduler Tasks UI are now standard plugins, each with dedicated badge styling, log types, and prompt files.
- Unified memory tools: The four separate memo

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON