Publishing Agents to the Hub

gaia agent init my-agent --language python
cd my-agent

my-agent/
├── gaia-agent.yaml        # the manifest the Hub reads (Step 3)
├── README.md              # becomes your agent's web page (Step 5)
├── pyproject.toml         # Python packaging + the GAIA "entry point" (Step 3)
└── <package>/             # your agent's code, e.g. gaia_agent_my_agent/
    ├── __init__.py        # exposes build_registration (how GAIA finds the agent)
    └── agent.py           # your agent class

id: my-agent                 # the short name used in URLs (/hub/my-agent); lowercase + hyphens
name: My Agent               # the display name shown to people
version: 0.1.0               # the release number (see "Versioning" — once published it can't change)
description: "One-line summary shown on the hub card"
author: your-name-or-org     # YOUR identity — shown on the hub; must match your token's scope (Step 6)
license: MIT

category: productivity       # one of: conversation | development | productivity | integrations | creative | vision
tags: [example, demo]        # free-text keywords for search
icon: sparkles               # an icon name from lucide.dev
tools_count: 3               # how many @tool functions your agent registers

language: python             # python | cpp
min_gaia_version: "0.20.0"   # the oldest GAIA version your agent works on
models: [Gemma-4-E4B-it-GGUF]  # the model(s) your agent expects

python:
  entry_module: my_agent     # the Python package to import
  entry_class: MyAgent       # your agent class inside it

requirements:                # what a machine needs to run it (shown as cards on your page)
  min_memory_gb: 8
  platforms: [win-x64, linux-x64, darwin-arm64]

interfaces:                  # the ways your agent can be used (see "Standalone sidecars")
  cli: true                  # `gaia <id> ...` on the command line
  pipe: true                 # piping text in/out
  api_server: false          # served over a local REST API
  mcp_server: false          # served over MCP (for tools like Claude/IDEs)

[project.entry-points."gaia.agent"]
my-agent = "gaia_agent_my_agent:build_registration"

from gaia.agents.base.agent import Agent
from gaia.agents.base.tools import tool

class MyAgent(Agent):
    def _get_system_prompt(self) -> str:
        # The agent's personality and rules, in plain language.
        return "You are My Agent. Be concise and use tools when helpful."

    def _register_tools(self):
        # Each @tool is a function the model can choose to call.
        # The docstring is how the model knows what the tool does — be descriptive.
        @tool
        def greet(name: str) -> str:
            """Return a friendly greeting for the given name."""
            return f"Hello, {name}!"

gaia agent login --hub      # prompts you to paste the Hub token (hidden input)
gaia agent login --pypi     # optional: a PyPI token, if you also publish to PyPI

export GAIA_HUB_TOKEN=***    # the Hub publish token
export PYPI_TOKEN=***        # optional, for PyPI

gaia agent test            # static quality gates: manifest, structure, black+isort (add --live for an LLM smoke test)
gaia agent status my-agent # show the installed version + basic health
gaia agent health my-agent # confirm it loads and its entry point resolves

gaia agent publish         # builds the package file (a "wheel") and uploads it to the Hub + PyPI

# Confirm your agent is in the catalog:
curl -s https://hub.amd-gaia.ai/index.json | grep my-agent

# Install it the way a user would (PyPI path):
pip install gaia-agent-my-agent
# …or browse and install it from the Agent UI's Hub panel.

dependencies = ["amd-gaia[api]>=0.20.0"]   # add ,rag / ,etc. for extra capabilities