> ## Documentation Index
> Fetch the complete documentation index at: https://amd-gaia.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# GAIA Agents Hub

> Agent registry, discovery, and remote testing platform for GAIA SDK agents

# GAIA Agents Hub

<Note>
  **Target:** Q2 2026 | **Status:** Planning | **Priority:** High
</Note>

<Warning>
  **Work in Progress** - This plan is actively being refined. Feedback welcome.
</Warning>

***

## 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

<Tip>
  **View Mockups:** Open `docs/plans/mockups/` in your local checkout and open the HTML files in a browser.
</Tip>

<CardGroup cols={2}>
  <Card title="Agents Hub" icon="grid">
    `agents-hub.html` - Browse and search published agents
  </Card>

  <Card title="Agent Arena" icon="play">
    `arena.html` - Test agents live on Strix Halo hardware
  </Card>
</CardGroup>

***

## 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/`](/docs/guides/chat)          |
| **CodeAgent**                                       | Code           | Code generation and editing               | [`agents/code/`](/docs/guides/code)          |
| **BlenderAgent**                                    | Creative       | 3D scene automation                       | [`agents/blender/`](/docs/guides/blender)    |
| **JiraAgent**                                       | Productivity   | Issue management with NLP                 | [`agents/jira/`](/docs/guides/jira)          |
| **DockerAgent**                                     | DevOps         | Container management                      | [`agents/docker/`](/docs/guides/docker)      |
| **MedicalIntakeAgent**                              | Healthcare     | Form processing with VLM                  | [`hub/agents/python/emr/`](/docs/guides/emr) |
| **RoutingAgent**                                    | Infrastructure | Intelligent agent selection               | [`agents/routing/`](/docs/guides/routing)    |
| **SDAgent**                                         | Creative       | Image generation with SD + VLM            | [`agents/sd/`](/docs/guides/sd)              |
| **Talk SDK** (voice I/O for agents)                 | Voice          | Speech-to-speech wrapper around any agent | [`gaia/talk/`](/docs/guides/talk)            |

Additional seeds expected when the underlying work lands:

* **ComputerUseAgent (CUA)** — planned for v0.21.0; see the
  [CUA plan](/docs/plans/cua).

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.

<Card title="View Mockup" icon="browser">
  Open `docs/plans/mockups/agents-hub.html` in browser
</Card>

**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.

<Card title="View Mockup" icon="play">
  Open `docs/plans/mockups/arena.html` in browser
</Card>

**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.

<Card title="View Mockup" icon="user">
  Open `docs/plans/mockups/profile.html` in browser
</Card>

**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.

***

## Agent Manifest Format

See also: [Agent Manifest (#462)](https://github.com/amd/gaia/issues/462)

```yaml theme={null}
# 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 taxbot`                        | Local installation            |
| **Desktop App**    | Browse in GAIA Desktop                             | GUI-based discovery           |
| **Direct Docker**  | `docker pull ghcr.io/amd/gaia-agents/taxbot:2.1.0` | Advanced users                |

### Agent Lifecycle Commands

```bash theme={null}
# 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](https://www.amd.com/en/developer.html) 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` repo | Community agent repository with CI/CD      |
| Agent submission pipeline         | `gaia agent publish` command               |
| Auto 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.html` | Main landing page with featured agents and categories |
| **Agent Arena**       | `arena.html`      | Agent testing interface with suggested queries        |
| **Developer Profile** | `profile.html`    | User profile with badges, stats, and agent history    |

***

## Related

* [Agent Manifest (#462)](https://github.com/amd/gaia/issues/462)
* [Agent System SDK](/docs/sdk/core/agent-system)
* [Quickstart Tutorial](/docs/quickstart)
* [GAIA SDK Documentation](https://amd-gaia.ai)

***

## 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                                                |