Import Agents
Learn how to import new agents to BeeAI
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:
How It Works
BeeAI discovers and runs agents automatically using the Agent Communication Protocol (ACP). When you add an agent:
- Auto-discovery: Agents running locally are automatically detected
- Containerization: Remote agents are built into Docker containers
- Registration: All agents appear in both CLI and web interface
Adding Agents
Local Development (Recommended for Development)
When building ACP-compliant agents locally, BeeAI automatically discovers them:
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:
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:
For advanced users: If you need more control over the build process:
Requirements:
- Directory must contain a Dockerfile
- Docker must be running locally
From Docker Images
Add pre-built Docker images:
Managing Agents
Check Agent Status
Shows all agents with their status, location, and any configuration issues.
Remove Agents
Get Agent Details
Shows documentation, capabilities, and configuration options.