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:
Agent Category Use Case Source GaiaAgent (née ChatAgent, renamed in v0.20.0)Documents Document Q&A with RAG agents/chat/CodeAgent Code Code generation and editing agents/code/BlenderAgent Creative 3D scene automation agents/blender/JiraAgent Productivity Issue management with NLP agents/jira/DockerAgent DevOps Container management agents/docker/MedicalIntakeAgent Healthcare Form processing with VLM agents/emr/RoutingAgent Infrastructure Intelligent agent selection agents/routing/SDAgent Creative Image generation with SD + VLM agents/sd/Talk SDK (voice I/O for agents)Voice Speech-to-speech wrapper around any agent gaia/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:
Tier Criteria Badge Member Joined AMD AI Developer Program — Contributor Published 1+ agent Contributor Builder 3+ agents or 100+ total downloads Builder
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.
Check What It Tests Responds Agent replies to 3 test prompts within timeout Stays on task Responses are relevant to the agent’s declared category No crashes Completes test suite without errors Safe No security violations in sandboxed environment
Agents that fail these gates are not published. Authors receive detailed failure logs.
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
Method Command Use Case Arena (Remote) Click “Try in Arena” Quick testing, no local setup CLI Install gaia agent install taxbotLocal installation Desktop App Browse in GAIA Desktop GUI-based discovery Direct Docker docker 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
Component Technology Responsibility Hub Frontend Web app (TBD) Agent browsing, search, profile pages Hub API REST API Agent metadata, search, ratings, downloads Agent Registry Container registry (ghcr.io) Docker image storage and versioning CI/CD Pipeline GitHub Actions on amd/gaia-agents Build, test, validate, publish Arena Backend AMD Strix Halo Developer Cloud Container orchestration, session management Arena UI Chat interface Proxies user input to running agent containers Auth AMD AI Developer Program SSO Identity for publishing, voting, profiles
Arena Infrastructure
Arena sessions run on AMD Strix Halo Developer Cloud , a separate infrastructure initiative.
Integration points:
Component Responsibility Cloud infrastructure External team (AMD Strix Halo Developer Cloud) Container orchestration External team Arena web UI Agents Hub team Agent deployment to Arena Agents 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
Action No Account AMD Dev Program Member Browse Agents Hub Yes Yes Try agents in Arena Yes Yes Install agents locally Yes Yes Run agents via Desktop App Yes Yes Submit agents No Yes Create profile No Yes Earn badges No Yes
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
Deliverable Description github.com/amd/gaia-agents repoCommunity agent repository with CI/CD Agent submission pipeline gaia agent publish commandAuto Docker build CI generates containers from GAIA SDK code Agent validation Automated gates (lint, test, health check) Basic Hub UI Browse, 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
Deliverable Description Arena infrastructure Strix Halo hosting with container orchestration Arena UI Chat interface to test any Hub agent Session management Isolated sessions with usage limits Hardware display Show hardware and model info per session Desktop app integration Try 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
Deliverable Description Profile system Badges, contribution stats, public/private toggle Rating system Users can rate and review agents Notification system Email/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
Deliverable Description Public launch Agents Hub live at hub.amd-gaia.ai Documentation Developer guide, submission tutorial, FAQ
Exit Criteria:
20+ agents in Hub (AMD + community)
End-to-end publish and install workflow documented and tested
Quality Metrics
Metric Target Arena uptime 99.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
Question Options Recommendation Multi-model support Single model vs. user choice Single default model per agent; user override later Agent sandboxing gVisor vs. Firecracker vs. Docker Docker with strict resource limits for MVP Arena session limits Fixed time vs. request count TBD based on infrastructure capacity
Operational
Question Consideration Moderation Community flagging + AMD review for takedown Disputes Clear rules published upfront; AMD team as final arbiter
Risks and Mitigations
Risk Likelihood Impact Mitigation Developer Cloud integration delays Medium High Early coordination, parallel workstreams Timeline slip Medium Medium Prioritize MVP; defer profiles/badges if needed Quality variance in submissions Medium Low Automated gates filter basics; community rates quality
UI Mockups
Interactive HTML mockups are available in docs/plans/mockups/:
Mockup File Description Agents Hub agents-hub.htmlMain landing page with featured agents and categories Agent Arena arena.htmlAgent testing interface with suggested queries Developer Profile profile.htmlUser profile with badges, stats, and agent history
Changelog
Date Change Apr 1, 2026 Rewritten as engineering-focused RFC; removed non-technical content Jan 26, 2026 Added ComputerUseAgent (CUA) to seed agents Jan 21, 2026 Renamed Arena to “Agent Arena”; added mockup links Jan 21, 2026 Initial plan created