Quickstart Guide

Get your first AI team mission running in four steps.

Step 1: Create Your Account

Sign up at burros.ai/signup to create your account.

Step 2: Set Up a Corral

A Corral is your AI team's workspace. Think of it as a department.

1. After signing in, go to Settings → Corrals (via your profile menu, top-right).
2. Click Create Corral and give it a name (e.g., "Engineering").
3. Select the Playbook this Corral should use (e.g., "SDLC Website" for software projects).

Step 3: Register a Burro

A Burro is the local compute engine that runs your AI agents. It connects to the portal securely while keeping code execution on your machine.

1. Go to your Corral's detail page in the portal.
2. Click Register Burro to generate a secure installation code. Note: This code expires in 24 hours.
3. Choose your installation method and run the command in your terminal:

Option A: Binary (CLI)

curl -fsSL https://www.burros.ai/install | bash -s -- -c YOUR_SECURE_CODE

Option B: Docker

mkdir -p ~/.burro && docker run --rm --pull always \
  -v ~/.burro:/usr/local/burros \
  burrosai/burro-js:latest \
  setup -c YOUR_SECURE_CODE && \
docker run -d --restart always \
  --name burro-agent \
  -v ~/.burro:/usr/local/burros \
  burrosai/burro-js:latest

1. Once the command completes, your Burro will start and appear in your Corral with a green "Online" status indicator.

Step 4: Create a Project & Launch a Mission

1. Go to Mission Control (top navigation).
2. Click Create New Project.
3. Give it a name, add a description, and optionally upload context files (design specs, architecture docs, etc.).
4. Click Create — your project is ready.
5. Define your mission objective in plain language (e.g., "Build a responsive landing page with a hero section and pricing table").
6. Click Launch Mission — your AI team takes over.

Tip: The more specific your mission objective, the better your agents will perform. Include technology preferences, design constraints, and acceptance criteria.