# Agent Zero docs for LLMs

Agent Zero is a personal, organic agentic framework with a Web UI, Docker runtime, Browser and Desktop Canvas surfaces, projects, memory, plugins, skills, model presets, and optional host-machine connectivity through A0 CLI.

## Start here

- [Installation](https://www.agent-zero.ai/p/docs/installation/): install Agent Zero, open the Web UI, and complete first-run setup.
- [First-Run Onboarding](https://www.agent-zero.ai/p/docs/onboarding/): set up a cloud provider or a local Ollama model such as gemma4:26b with the guided wizard.
- Quick install: Windows PowerShell: `irm https://ps.agent-zero.ai | iex`; macOS/Linux: `curl -fsSL https://bash.agent-zero.ai | bash`.
- Docker quick run, if Docker is already installed: `docker run -p 80:80 -v a0_usr:/a0/usr agent0ai/agent-zero`.
- Optional host connector: Windows PowerShell: `irm https://cli.agent-zero.ai/install.ps1 | iex`; macOS/Linux: `curl -LsSf https://cli.agent-zero.ai/install.sh | sh`.

## Capability map

- Agent Zero is one Docker container with a full Linux system, Web UI, Browser, Desktop, Plugin Hub, and Skills.
- Use Desktop for GUI software, files, and LibreOffice Writer/Calc/Impress cowork in ODT, ODS, and ODP formats.
- Use Browser for live web pages, screenshots, forms, downloads, extensions, host-browser mode, and Annotate mode for targeted page comments.
- Use the Markdown Editor for plans, TODOs, notes, RFCs, and other text artifacts that should live outside chat history.
- Use Plugin Hub, MCP/A2A, custom prompts, tools, projects, and model presets to extend or specialize Agent Zero.
- Use Orchestrator for supported coding-agent backends, slash commands for repeatable actions, and per-chat goals for visible progress.
- Use A0 CLI when Agent Zero should work with host files, terminals, repositories, or an approved host browser while Agent Zero remains isolated in Docker.

## Practical guides

- [A0 CLI Connector](https://www.agent-zero.ai/p/docs/a0-cli-connector/): connect the host terminal, local files, and an approved host browser to Agent Zero.
- [Browser](https://www.agent-zero.ai/p/docs/browser/): use the Browser Canvas for web pages, screenshots, annotations, settings, and host-browser mode.
- [Desktop](https://www.agent-zero.ai/p/docs/desktop/): use the Desktop Canvas for GUI apps, files, and LibreOffice Cowork.
- [Projects](https://www.agent-zero.ai/p/docs/projects/): create focused workspaces with instructions, files, memory, variables, secrets, and Git repositories.
- [Model Presets](https://www.agent-zero.ai/p/docs/model-presets/): switch model setups for speed, cost, local work, or maximum capability.
- [Agent Profiles](https://www.agent-zero.ai/p/docs/agent-profiles/): change a chat's role, tone, workflow, and prompt behavior.
- [Skills](https://www.agent-zero.ai/p/docs/skills/): pin focused procedures to a chat when a workflow needs repeatable instructions.
- [Plugins](https://www.agent-zero.ai/p/docs/plugins/): manage plugins, browse the Plugin Hub, and keep local plugins under `usr/plugins`.
- [Create a Small Plugin](https://www.agent-zero.ai/p/docs/create-plugin/): build a tiny local Web UI plugin as a learning path.
- [Prompts](https://www.agent-zero.ai/p/docs/prompts/): customize behavior safely through user-owned profiles under `usr/agents`.
- [Subagents](https://www.agent-zero.ai/p/docs/subagents/): ask Agent Zero to delegate focused parts of a larger task.
- [Memory](https://www.agent-zero.ai/p/docs/memory/): view, edit, and manage stored memories.
- [Task Scheduler](https://www.agent-zero.ai/p/docs/task-scheduler/): schedule one-off or recurring Agent Zero work.
- [MCP / A2A](https://www.agent-zero.ai/p/docs/mcp-a2a/): connect external tools and agent-to-agent flows.
- [Secrets](https://www.agent-zero.ai/p/docs/secrets/): store credentials securely and reference them by name.
- [Sharing](https://www.agent-zero.ai/p/docs/sharing/): share an instance safely with teammates.
- [Updating](https://www.agent-zero.ai/p/docs/updating/): keep Agent Zero current and preserve data.
- [Community](https://www.agent-zero.ai/p/docs/community/): get help and contribute.
- [Changelog](https://www.agent-zero.ai/p/docs/changelog/): release notes by version.

## User-owned customization rule

For profiles, prompts, plugins, projects, and similar customizations, prefer `usr` paths. Rule of thumb: if something in `/a0/usr` has the same ID as something in the root `/a0` area, the user-owned version replaces or extends the root version. Keep root files as the base install and put user edits under `/a0/usr`.

Safety shorthand: keep Agent Zero isolated in Docker or another sandbox, avoid mounting an entire home directory unless you understand the risk, grant A0 CLI host access only for trusted machines/workspaces, store credentials in Secrets or project secrets, and review actions that affect accounts, money, production systems, or private data.

For source-linked architecture details, use DeepWiki: https://deepwiki.com/agent0ai/agent-zero