whatisgithub

What is agent-zero?

agent0ai/agent-zero — explained in plain English

Analysis updated 2026-06-24

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

In one sentence

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

What do people build with it?

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.

What is it built with?

PythonDockerKali Linux

How does it compare?

agent0ai/agent-zeromnielsen/neural-networks-and-deep-learningpytorch/vision
Stars17,65017,65117,675
LanguagePythonPythonPython
Setup difficultyhardmoderatemoderate
Complexity4/52/54/5
Audiencedeveloperresearcherresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get 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.

So what is it?

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?

Frequently asked questions

What is agent-zero?

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.

What language is agent-zero written in?

Mainly Python. The stack also includes Python, Docker, Kali Linux.

How hard is agent-zero to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is agent-zero for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.