explaingit

agent0ai/agent-zero

17,650PythonAudience · developerComplexity · 4/5Setup · hard

TLDR

A framework that gives an AI model a real Linux computer to work in, it can run code, browse the web, edit files, and install software inside a Docker container to complete open-ended tasks you assign it.

Mindmap

mindmap
  root((repo))
    What it does
      Autonomous AI agent
      Real computer control
    Capabilities
      Run code and scripts
      Browse the web
      Edit documents
    Interface
      Web UI
      Canvas panel
      Linux desktop
    Setup
      Docker container
      Bring your own LLM
      A0 CLI Connector
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Let an AI agent autonomously install software, write scripts, and run them inside a safe Docker container to complete a multi-step task.

USE CASE 2

Have the agent browse the web, click through pages, fill forms, and take screenshots to complete research or data-gathering tasks.

USE CASE 3

Work side by side with the agent on documents in LibreOffice through a shared Linux desktop visible in the browser UI.

USE CASE 4

Connect Agent Zero to your host machine via the CLI Connector to let it manage files and run commands outside the container.

Tech stack

PythonDockerKali Linux

Getting it running

Difficulty · hard Time to first run · 1h+

Requires Docker and a separate LLM provider account or API key, the Kali Linux container image is large to download.

In plain English

Agent Zero is a framework for building and running AI agents that can use a real Linux computer to get work done. Instead of being a single-purpose chatbot or a fixed list of skills, it gives a large language model a working environment: a terminal, a file system, a web browser, memory of past projects, and the ability to write and run code. The agent figures out how to use those pieces to solve whatever task you give it, and can build new tools for itself along the way. The agent runs inside a Kali Linux environment (a Linux distribution) packaged in Docker, with a Web UI on top. From there it can inspect and edit files, install software, run scripts, search the web, and adapt its plan as a task evolves. A right-side panel called the Canvas makes the work visible: you can watch the browser session, see documents being edited, inspect workspace history, and step in before a mistake compounds. A native Browser lets the agent click, type, take screenshots, and use Chrome extensions, while an annotation mode lets you point at parts of a page and leave instructions. A Desktop surface adds a full Linux desktop with LibreOffice (Writer, Calc, Impress), so you and the agent can edit the same documents side by side. A separate A0 CLI Connector bridges a running Agent Zero instance to your host machine when you want it to work outside the container. You bring your own large language model, connecting through providers or, with the new OAuth flow, through an OpenAI Codex plan. Agent Zero would suit someone who wants an autonomous, transparent assistant that can take open-ended goals and operate a real computer rather than just generate text. The project is written in Python.

Copy-paste prompts

Prompt 1
I want to set up Agent Zero with my own API key inside Docker. Walk me through the steps from cloning the repo to running the first task in the web UI.
Prompt 2
How do I use Agent Zero's Canvas panel to monitor what the agent is doing in the browser and step in to correct a mistake before it goes wrong?
Prompt 3
I want Agent Zero to research a topic online, write a summary, and save it to a file. Write the task prompt I should give it and explain what steps it will take.
Prompt 4
How do I connect Agent Zero to an OpenAI Codex plan using the new OAuth flow instead of a raw API key?
Open on GitHub → Explain another repo

← agent0ai on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.