Skip to main content

GAIA Agents Hub

Target: Q2 2026 | Status: Planning | Priority: High
Work in Progress - This plan is actively being refined. Feedback welcome.

Overview

The GAIA Agents Hub is a platform for publishing, discovering, and running AI agents built on the GAIA SDK. It provides:
  • A searchable agent registry for browsing and installing agents
  • An Agent Arena backed by AMD Strix Halo cloud hardware for remote testing
  • A CI/CD pipeline for validating, packaging, and deploying agent submissions
  • CLI integration via gaia agent commands for local install and publish workflows
View Mockups: Open docs/plans/mockups/ in your local checkout and open the HTML files in a browser.

Agents Hub

agents-hub.html - Browse and search published agents

Agent Arena

arena.html - Test agents live on Strix Halo hardware

Seed Agents

The Hub launches with existing GAIA agents as initial content:
AgentCategoryUse CaseSource
GaiaAgent (née ChatAgent, renamed in v0.20.0)DocumentsDocument Q&A with RAGagents/chat/
CodeAgentCodeCode generation and editingagents/code/
BlenderAgentCreative3D scene automationagents/blender/
JiraAgentProductivityIssue management with NLPagents/jira/
DockerAgentDevOpsContainer managementagents/docker/
MedicalIntakeAgentHealthcareForm processing with VLMagents/emr/
RoutingAgentInfrastructureIntelligent agent selectionagents/routing/
SDAgentCreativeImage generation with SD + VLMagents/sd/
Talk SDK (voice I/O for agents)VoiceSpeech-to-speech wrapper around any agentgaia/talk/
Additional seeds expected when the underlying work lands:
  • ComputerUseAgent (CUA) — planned for v0.21.0; see the CUA plan.
These agents serve as reference implementations and starter templates for community submissions.

Core Components

1. Agent Registry

The central repository for discovering and installing agents.

View Mockup

Open docs/plans/mockups/agents-hub.html in browser
Features:
  • Browse and search agents by category, tags, and use case
  • View ratings, download counts, and version history
  • One-click “Try in Arena” or gaia agent install <name>
  • AMD-maintained agents alongside community submissions
Agent Sources:
  • Official agents maintained in github.com/amd/gaia
  • Community agents submitted to github.com/amd/gaia-agents

2. Agent Arena

Remote agent testing environment running on AMD Strix Halo hardware. Users can interact with any published agent without local installation.

View Mockup

Open docs/plans/mockups/arena.html in browser
Features:
  • Chat interface for testing any Hub agent
  • Runs on AMD Strix Halo Developer Cloud infrastructure (NPU-enabled)
  • Isolated sessions per user with usage limits
  • Hardware and model info displayed for transparency
  • No account required to try agents
Technical Details:
  • Each agent runs in a Docker container on Strix Halo hardware
  • Sessions are isolated via container-level separation
  • The Arena exposes a chat UI that proxies to the running agent’s API endpoint
  • Session timeout and concurrency limits are enforced at the orchestration layer

3. Developer Profiles and Badges

A system for tracking contributions and recognizing active developers.

View Mockup

Open docs/plans/mockups/profile.html in browser
Recognition Tiers:
TierCriteriaBadge
MemberJoined AMD AI Developer Program
ContributorPublished 1+ agentContributor
Builder3+ agents or 100+ total downloadsBuilder
Profile Features:
  • Public or private profile visibility (developer’s choice)
  • Contribution history: published agents, versions, download stats
  • Badge display based on contribution tiers above

4. Agent Quality Gates

Automated validation that every submitted agent must pass before it appears in the Hub.
CheckWhat It Tests
RespondsAgent replies to 3 test prompts within timeout
Stays on taskResponses are relevant to the agent’s declared category
No crashesCompletes test suite without errors
SafeNo security violations in sandboxed environment
Agents that fail these gates are not published. Authors receive detailed failure logs.

Agent Manifest Format

See also: Agent Manifest (#462)
# agent.yaml
name: "taxbot"
version: "2.1.0"
author: "@janedoe"
description: "AI assistant for tax preparation and filing"
category: "productivity"

# Discoverability
tags: ["finance", "tax", "documents", "forms"]
use_cases:
  - "Prepare tax returns"
  - "Find deductions"
  - "Explain tax concepts"

# Technical
model: "Qwen3.5-35B"          # Preferred model
min_gaia_version: "0.15.0"       # Compatibility
requirements:                     # Python dependencies
  - "pypdf>=3.0.0"

# Optional
homepage: "https://github.com/janedoe/taxbot"
license: "MIT"
The agent.yaml manifest is validated during the CI/CD pipeline. Required fields: name, version, author, description, category, model, min_gaia_version.

CLI Commands

Distribution Methods

MethodCommandUse Case
Arena (Remote)Click “Try in Arena”Quick testing, no local setup
CLI Installgaia agent install taxbotLocal installation
Desktop AppBrowse in GAIA DesktopGUI-based discovery
Direct Dockerdocker pull ghcr.io/amd/gaia-agents/taxbot:2.1.0Advanced users

Agent Lifecycle Commands

# Discover
gaia agent list                    # List available agents
gaia agent search "tax"            # Search by keyword
gaia agent info taxbot             # View agent details

# Install and run
gaia agent install taxbot          # Install locally
gaia agent run taxbot              # Run an installed agent
gaia agent update taxbot           # Update to latest version
gaia agent uninstall taxbot        # Remove agent

# Publish
gaia agent test                    # Run local validation
gaia agent publish                 # Submit to Hub via CI/CD

Technical Architecture

Agent Submission Pipeline

Developer                          Platform                              Hub
--------                           --------                              ---

1. Create agent
   +-- Python + agent.yaml

2. gaia agent publish        --->  3. CI/CD Pipeline
                                      |-- Validate agent.yaml
                                      |-- Run linter
                                      |-- Execute test suite
                                      |-- Build Docker image
                                      +-- Push to registry

                                   4. Automated Gates         --->  5. Hub Listing
                                      |-- Health check                  |-- Version registered
                                      |-- Response test                 |-- Searchable
                                      +-- Safety scan                   +-- Arena-ready

System Components

ComponentTechnologyResponsibility
Hub FrontendWeb app (TBD)Agent browsing, search, profile pages
Hub APIREST APIAgent metadata, search, ratings, downloads
Agent RegistryContainer registry (ghcr.io)Docker image storage and versioning
CI/CD PipelineGitHub Actions on amd/gaia-agentsBuild, test, validate, publish
Arena BackendAMD Strix Halo Developer CloudContainer orchestration, session management
Arena UIChat interfaceProxies user input to running agent containers
AuthAMD AI Developer Program SSOIdentity for publishing, voting, profiles

Arena Infrastructure

Arena sessions run on AMD Strix Halo Developer Cloud, a separate infrastructure initiative. Integration points:
ComponentResponsibility
Cloud infrastructureExternal team (AMD Strix Halo Developer Cloud)
Container orchestrationExternal team
Arena web UIAgents Hub team
Agent deployment to ArenaAgents Hub team (via CI/CD)
Assumptions:
  • Developer Cloud provides API for session management
  • Developer Cloud supports Docker container execution
  • Developer Cloud exposes Strix Halo NPU to containers

Access Model

ActionNo AccountAMD Dev Program Member
Browse Agents HubYesYes
Try agents in ArenaYesYes
Install agents locallyYesYes
Run agents via Desktop AppYesYes
Submit agentsNoYes
Create profileNoYes
Earn badgesNoYes
Authentication uses AMD AI Developer Program SSO. Membership is free and open to all.

Implementation Phases

Phase 1: Foundation (Feb 2026)

Objective: Core infrastructure and MVP submission pipeline
DeliverableDescription
github.com/amd/gaia-agents repoCommunity agent repository with CI/CD
Agent submission pipelinegaia agent publish command
Auto Docker buildCI generates containers from GAIA SDK code
Agent validationAutomated gates (lint, test, health check)
Basic Hub UIBrowse, search, agent detail pages
Exit Criteria:
  • AMD team can publish 3+ seed agents
  • External contributor can submit a PR and see their agent published
  • Agents are accessible via gaia agent install <name>

Phase 2: Agent Arena (Mar 2026)

Objective: Live agent testing on AMD hardware
DeliverableDescription
Arena infrastructureStrix Halo hosting with container orchestration
Arena UIChat interface to test any Hub agent
Session managementIsolated sessions with usage limits
Hardware displayShow hardware and model info per session
Desktop app integrationTry agents from GAIA Desktop
Exit Criteria:
  • Anyone can try 10+ agents in Arena without signup
  • Arena handles 50+ concurrent users
  • Average response time < 3 seconds

Phase 3: Profiles and Ratings (Apr 2026)

Objective: Developer profiles, badges, and community ratings
DeliverableDescription
Profile systemBadges, contribution stats, public/private toggle
Rating systemUsers can rate and review agents
Notification systemEmail/Discord alerts for publish events and reviews
Exit Criteria:
  • Profiles display accurate badge tiers and stats
  • Ratings are reflected in Hub search ranking

Phase 4: Public Launch (May-Jun 2026)

Objective: Public availability with documentation
DeliverableDescription
Public launchAgents Hub live at hub.amd-gaia.ai
DocumentationDeveloper guide, submission tutorial, FAQ
Exit Criteria:
  • 20+ agents in Hub (AMD + community)
  • End-to-end publish and install workflow documented and tested

Quality Metrics

MetricTarget
Arena uptime99.5%
Average Arena response time< 3 seconds
Agent submission to publish time< 10 minutes
Agent gate pass rate> 80%
Hub API latency (p95)< 200ms

Open Questions

Technical

QuestionOptionsRecommendation
Multi-model supportSingle model vs. user choiceSingle default model per agent; user override later
Agent sandboxinggVisor vs. Firecracker vs. DockerDocker with strict resource limits for MVP
Arena session limitsFixed time vs. request countTBD based on infrastructure capacity

Operational

QuestionConsideration
ModerationCommunity flagging + AMD review for takedown
DisputesClear rules published upfront; AMD team as final arbiter

Risks and Mitigations

RiskLikelihoodImpactMitigation
Developer Cloud integration delaysMediumHighEarly coordination, parallel workstreams
Timeline slipMediumMediumPrioritize MVP; defer profiles/badges if needed
Quality variance in submissionsMediumLowAutomated gates filter basics; community rates quality

UI Mockups

Interactive HTML mockups are available in docs/plans/mockups/:
MockupFileDescription
Agents Hubagents-hub.htmlMain landing page with featured agents and categories
Agent Arenaarena.htmlAgent testing interface with suggested queries
Developer Profileprofile.htmlUser profile with badges, stats, and agent history


Changelog

DateChange
Apr 1, 2026Rewritten as engineering-focused RFC; removed non-technical content
Jan 26, 2026Added ComputerUseAgent (CUA) to seed agents
Jan 21, 2026Renamed Arena to “Agent Arena”; added mockup links
Jan 21, 2026Initial plan created