Migration

Migration Guide

From Internal Agent to External Package

Before (internal GAIA agent):

# src/gaia/agents/my_agent/agent.py
from gaia.agents.base.agent import Agent

class MyAgent(Agent):
    # Implementation
    pass

After (external package):

# my-gaia-agent/src/my_agent/agent.py
from gaia.agents.base.agent import Agent

class MyAgent(Agent):
    # Same implementation
    pass

# pyproject.toml
[project.entry-points."gaia.agents"]
my-agent = "my_agent.agent:MyAgent"

Installation:

pip install my-gaia-agent
# Agent auto-discovered by GAIA!

---

Related Topics

• Core Agent System - Agent architecture
• Application Packaging - Package agents for distribution
• Best Practices - Development guidelines
• Developer Guide - Development environment setup

---