BeeAI provides multiple ways to add agents to your platform. This guide explains each method and when to use them.

​
Prerequisite

​
Docker Setup

Most import methods require Docker to be running:
  • macOS: Install Docker Desktop or Rancher Desktop
  • Linux: Install Docker Engine and QEMU
  • Windows: Install Docker Desktop

​
Quick Start

Just want to get started? Try importing a ready-made agent: 
beeai add https://github.com/i-am-bee/beeai-platform-agent-starter.git

​
How It Works

BeeAI discovers and runs agents automatically using the Agent Communication Protocol (ACP). When you add an agent:
  1. Auto-discovery: Agents running locally are automatically detected
  2. Containerization: Remote agents are built into Docker containers
  3. Registration: All agents appear in both CLI and web interface

​
Adding Agents

When building ACP-compliant agents locally, BeeAI automatically discovers them: 
# Start your agent server
uv run my_agent.py

# Your agent automatically appears in BeeAI
beeai list  # Shows your local agent
Benefits:
  • Instant feedback during development
  • No build process needed
  • Changes reflected immediately
Requirements:
  • Agent must implement ACP protocol
  • Must be running on accessible port

​
From GitHub Repositories

Import agents directly from public GitHub repositories: 
# Basic import
beeai add "https://github.com/username/my-agent.git"

# With specific version
beeai add "https://github.com/username/my-agent.git#v1.0.0"

# With specific branch
beeai add "https://github.com/username/my-agent.git#develop"

# From subdirectory
beeai add "https://github.com/username/my-agent.git#:agents/my-agent"

# Combined version and path
beeai add "https://github.com/username/multi-agent-repo.git#v2.1.0:agents/specialized-agent"
Requirements:
  • Repository must contain a Dockerfile
  • Agent must follow ACP protocol
  • Repository must be publicly accessible
  • Docker must be running locally

​
From Local Filesystem

Build and add agents from your local machine: 
# Add from current directory
beeai add .

# Add from specific directory
beeai add /path/to/my-agent
For advanced users: If you need more control over the build process: 
# Build only (for testing)
beeai build /path/to/my-agent --no-import

# Build with custom tag
beeai build . --tag my-custom-agent:dev

# Add the built image separately
beeai add beeai.local/my-agent-hash:latest
Requirements:
  • Directory must contain a Dockerfile
  • Docker must be running locally

​
From Docker Images

Add pre-built Docker images: 
# From GitHub Container Registry
beeai add ghcr.io/i-am-bee/beeai-platform/community/aider:latest

# From Docker Hub
beeai add myuser/my-agent:v1.0

# From private registry
beeai add registry.example.com/team/custom-agent:latest

​
Managing Agents

​
Check Agent Status

beeai list
Shows all agents with their status, location, and any configuration issues.

​
Remove Agents

beeai remove <agent-name>

# Alternative commands
beeai uninstall <agent-name>
beeai delete <agent-name>
beeai rm <agent-name>

​
Get Agent Details

beeai info <agent-name>
Shows documentation, capabilities, and configuration options.