docs

Agent Zero Documentation

Welcome to the Agent Zero documentation hub. Start with the practical guides below: install it, open the Web UI, connect your host machine when needed, and learn the main workflows by sight.

For architecture and source-linked internals, use DeepWiki for Agent Zero. The local docs focus on practical setup, screenshots, and user workflows.

Quick Start

• Quickstart Guide: Get up and running in 5 minutes with Agent Zero.
• Agent Zero Launcher: Use the desktop app to set up Docker, install Agent Zero, open Instances, or connect a remote Instance.
• First-Run Onboarding: Choose Cloud or Local, add a provider key, and select main and utility models.
• Installation Guide: A0 Launcher downloads, A0 Install, direct Docker, updates, and advanced Docker setup (includes How to Update).
• A0 CLI Connector: Install the host connector for a running Agent Zero instance, use the command palette, and switch Browser modes.
• Self Update: How the in-app updater works (technical reference).
• VPS Deployment: Deploy Agent Zero on a remote server.
• Development Setup: Set up a local development environment.

User Guides

• Usage Guide: Practical tour of Agent Zero's main workflows.
• Agent Zero Launcher: Fresh-machine Launcher walkthrough, Docker setup gate, Installs, Instances, and docs screenshot capture with Playwright/Electron.
• First-Run Onboarding: Set up OpenRouter, our proxy API or another provider with the guided wizard.
• Browser Guide: Use the built-in Browser, live Canvas surface, annotations, screenshots, host browser mode, and extensions.
• Desktop Guide: Use the built-in Linux desktop, GUI apps, and LibreOffice Writer/Calc/Impress Cowork.
• A0 CLI Connector: Terminal-first host connector for Agent Zero, with screenshots of the host picker, connected shell, command palette, and Browser modes.
• Create a Small Plugin: Build and review a tiny Web UI plugin that adds an unread dot to the chat list.
• Skills Guide: Open the Skills selector, add active skills, and remove prompt protocol entries you no longer need.
• Agent Profiles: Switch the current chat profile or create a new guided profile from the chat input.
• Model Presets: Create simple named shortcuts for model setups.
• Memory Guide: Search, edit, delete, and curate memories so useful context does not become stale noise.
• Projects Tutorial: Learn to create isolated workspaces with dedicated context and memory.
• API Integration: Add external APIs without writing code.
• MCP Setup: Configure Model Context Protocol servers.
• A2A Setup: Enable agent-to-agent communication.
• Troubleshooting: Solutions to common issues and FAQs.

Technical Reference

• DeepWiki for Agent Zero: Architecture, Web UI internals, plugin lifecycle, backend APIs, deployment details, and source-linked explanations.
• Architecture: Short local handoff to DeepWiki plus practical starting points.
• Plugins: Compact plugin starting points and sharing checklist.
• Extensions: Short guide for when an extension is the right tool.
• Connectivity: Choose between A0 CLI, MCP, A2A, and external APIs.
• WebSockets: Short local handoff to DeepWiki and source files.
• MCP Configuration: Compact reference for MCP JSON.
• Notifications: Notification system architecture and setup.
• Contributing Skills: Create and share agent skills.
• Contributing Guide: Contribute to the Agent Zero project.

Community & Support

• Join the Community: Connect with other users on Discord to discuss ideas, ask questions, and collaborate.
• Share Your Work: Show off your Agent Zero creations and workflows in the Show and Tell area.
• Report Issues: Use the GitHub issue tracker to report bugs or suggest features.
• Follow Updates: Subscribe to the YouTube channel for tutorials and release videos.

---

Table of Contents

• Quick Start

  • Quickstart Guide
  • Agent Zero Launcher
  • First-Run Onboarding
  • Installation Guide
    • How to Update Agent Zero
    • Manual Installation (Advanced)
    • Step 1: Install Docker Desktop
      • Windows Installation
      • macOS Installation
      • Linux Installation
    • Step 2: Run Agent Zero
      • Pull Docker Image
      • Map Folders for Persistence
      • Run the Container
      • Access the Web UI
    • Step 3: Configure Agent Zero
      • Settings Configuration
      • Agent Configuration
      • Chat Model Settings
      • API Keys
      • Authentication
    • Choosing Your LLMs
    • Installing Ollama (Local Models)
    • Using on Mobile Devices
  • Self Update (technical)
  • VPS Deployment
  • Development Setup
  • A0 CLI Connector

• User Guides

  • Usage Guide
    • Basic Operations
    • Plugins And Plugin Hub
    • Skills, Agent Profiles, And Model Presets
      • Skills
      • Agent Profiles
      • Model Presets
    • File Attachments
    • Tool Usage
      • Browser Tool And Surface
      • Desktop Surface
      • Agent-To-Agent Communication
      • Multi-Agent Cooperation
    • Projects
    • Tasks And Scheduling
    • Secrets And Variables
    • Remote Access Via Tunneling
    • Voice Interface
    • Mathematical Expressions
    • File Browser
    • Memory Management
    • Backup And Restore
  • Agent Zero Launcher
  • Browser Guide
  • Desktop Guide
  • A0 CLI Connector
  • Create a Small Plugin
  • Skills Guide
  • Agent Profiles
  • Model Presets
  • Memory Guide
  • Projects Tutorial
  • API Integration
  • MCP Setup
  • A2A Setup
  • Troubleshooting

• Technical Reference

  • DeepWiki for Agent Zero
  • Architecture
  • Plugins
  • Extensions
  • Connectivity
  • WebSockets
  • MCP Configuration
  • Notifications
  • Contributing Skills
  • Contributing Guide

---

Documentation Ownership

Content type	Home
Setup, screenshots, and everyday workflows	These docs
Architecture and source-linked internals	DeepWiki
Exact behavior	The current source code
Community help and examples	Discord, Skool, GitHub discussions

Your journey with Agent Zero starts now!

Ready to dive in? Start with the Quickstart Guide for the fastest path to your first chat, or follow the Installation Guide for a detailed setup walkthrough.