Skip to content

README.md

Latest commit

 

History

History
136 lines (85 loc) · 3.14 KB

README.md

File metadata and controls

136 lines (85 loc) · 3.14 KB

a0-install

Installation scripts for Agent Zero.

These scripts install and manage Agent Zero as a Docker container (agent0ai/agent-zero) and can create multiple named instances on the same machine.

Quick install (single command)

macOS / Linux

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

Windows (PowerShell)

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

Docker (manual, single instance)

If you just want a single instance on port 80:

docker run -p 80:80 agent0ai/agent-zero

Run from this repository (local)

macOS / Linux

bash ./install.sh

Windows

Run in PowerShell:

pwsh -File .\install.ps1

Prerequisites

  • Docker Engine / Docker Desktop
  • Docker Compose plugin (docker compose)

Notes:

  • On macOS, the script can open Docker Desktop for you, but you still need it installed.
  • On Linux, install.sh will attempt to install Docker via https://get.docker.com if docker is not found.
  • On Windows, install.ps1 will not install Docker automatically; it will direct you to install Docker Desktop.

What the installer does

Both install.sh and install.ps1 implement the same flow:

  • Detect existing Agent Zero containers (agent0ai/agent-zero).
  • If none exist, start the create instance flow.
  • If instances exist, show a menu:
    • Install new instance
    • Manage existing instances
    • Exit

Instance creation

When you create a new instance, the installer will prompt you for:

  • Version tag (from Docker Hub tags, defaults to latest)
  • Instance/container name (default: agent-zero, or agent-zero-2, ...)
  • Data directory (default: ~/agent-zero/<instance>/usr)
  • Web UI port (default: first free port starting at 5080)
  • Optional basic auth (username; password defaults to 12345678)

Then it:

  • Writes a per-instance docker-compose.yml
  • Pulls the image
  • Starts the container via docker compose up -d
  • Waits for the UI to respond (tries http://localhost:<port>)

Where files are stored

The installer creates a per-instance directory:

  • ~/agent-zero/<instance>/docker-compose.yml

And mounts your data directory into the container:

  • Host: ~/agent-zero/<instance>/usr (by default)
  • Container: /a0/usr

Managing instances

If you re-run the installer and existing instances are detected, you can manage them from the menu.

Per instance actions:

  • Open in browser
  • Start / Stop / Restart
  • Delete (removes the Docker container)

Uninstall

Uninstall is essentially:

  1. Delete the container(s)
  2. Remove the data directory (optional)

You can delete containers either through the installer menu or directly:

docker ps -a --filter "ancestor=agent0ai/agent-zero"
docker rm -f <container_name>

Then optionally remove the local files:

rm -rf ~/agent-zero

Security note about one-liners

The one-liners (curl ... | bash and irm ... | iex) execute remote code.

If you prefer to inspect first:

  • Download this repository and run bash ./install.sh or pwsh -File .\install.ps1.

Related projects