Once you’ve built an agent, there are several ways to share it with others.

Projects must follow the structure defined by the beeai-platform-agent-starter template for proper sharing functionality.

​
Share via GitHub

The easiest way to share your agent is by pushing it to a public GitHub repository.

Share your repository URL:

# Share the main branch
https://github.com/your-username/your-agent-repo

# Share a specific version
https://github.com/your-username/your-agent-repo#v1.0.0

Others can install your agent using the BeeAI CLI:

# Add from main branch (latest)
beeai add "https://github.com/your-username/your-agent-repo"

# Add specific version
beeai add "https://github.com/your-username/your-agent-repo#v1.0.0"

# Add with specific path (for monorepos)
beeai add "https://github.com/your-username/monorepo#main:agents/my-agent"

Versioning Tip: Use Git tags like v1.0.0, v1.1.0, etc., to manage releases before sharing them. This will help you prevent unwanted updates compared to always using latest main. You can upgrade agents by deleting them with beeai remove and adding again with the new version.

​
Share via Container Registry

You can also share pre-built Docker images for even faster installation:

# GitHub Container Registry (public)
beeai add ghcr.io/your-username/your-agent:latest
beeai add ghcr.io/your-username/your-agent:v1.0.0

# Docker Hub
beeai add your-username/your-agent:latest

# Private registries
beeai add registry.yourcompany.com/team/agent:v2.1.0

Why Containers? Pre-built images install instantly—they don’t need to be built on the user’s machine.

CI/CD Ready: The starter template includes a full GitHub Actions workflow to automate builds. See the build-agent.yaml file for details.

​
Publish to the Community Catalog

Want to make your agent discoverable by the entire BeeAI community? Add it to the communuity BeeAI catalog!

To contribute:

Thank you for sharing your work! 💛