AI Hub

Share models and agents with your organization. Show developers what's available without needing to rebuild them.

This feature is available in v1.74.3-stable and above.

Overview

Admin can select models/agents to expose on public AI hub → Users go to the public url and see what's available.

Models

How to use

1. Go to the Admin UI

Navigate to the Model Hub page in the Admin UI (PROXY_BASE_URL/ui/?login=success&page=model-hub-table)

2. Select the models you want to expose

Click on Select Models to Make Public and select the models you want to expose.

3. Confirm the changes

4. Success!

Go to the public url (PROXY_BASE_URL/ui/model_hub_table) and see available models.

API Endpoints

• GET /public/model_hub – returns the list of public model groups. Requires a valid user API key.
• GET /public/model_hub/info – returns metadata (docs title, version, useful links) for the public model hub.

Agents

info

Agents are only available in v1.79.4-stable and above.

Share pre-built agents (A2A spec) across your organization. Users can discover and use agents without rebuilding them.

Demo Video

1. Create an agent

Create an agent that follows the A2A spec.

UI

API

curl -X POST 'http://0.0.0.0:4000/v1/agents' \
--header 'Authorization: Bearer <your-master-key>' \
--header 'Content-Type: application/json' \
--data '{
  "agent_name": "hello-world-agent",
  "agent_card_params": {
    "protocolVersion": "1.0",
    "name": "Hello World Agent",
    "description": "Just a hello world agent",
    "url": "http://localhost:9999/",
    "version": "1.0.0",
    "defaultInputModes": ["text"],
    "defaultOutputModes": ["text"],
    "capabilities": {
      "streaming": true
    },
    "skills": [
      {
        "id": "hello_world",
        "name": "Returns hello world",
        "description": "just returns hello world",
        "tags": ["hello world"],
        "examples": ["hi", "hello world"]
      }
    ]
  }
}'

Expected Response

{
  "agent_id": "123e4567-e89b-12d3-a456-426614174000",
  "agent_name": "hello-world-agent",
  "agent_card_params": {
    "protocolVersion": "1.0",
    "name": "Hello World Agent",
    "description": "Just a hello world agent",
    "url": "http://localhost:9999/",
    "version": "1.0.0",
    "defaultInputModes": ["text"],
    "defaultOutputModes": ["text"],
    "capabilities": {
      "streaming": true
    },
    "skills": [
      {
        "id": "hello_world",
        "name": "Returns hello world",
        "description": "just returns hello world",
        "tags": ["hello world"],
        "examples": ["hi", "hello world"]
      }
    ]
  },
  "created_at": "2025-11-15T10:30:00Z",
  "created_by": "user123"
}

2. Make agent public

Make the agent discoverable on the AI Hub.

UI

Navigate to the Agents Tab on the AI Hub page

Select the agents you want to make public and click on Make Public button.

API

Option 1: Make single agent public

curl -X POST 'http://0.0.0.0:4000/v1/agents/123e4567-e89b-12d3-a456-426614174000/make_public' \
--header 'Authorization: Bearer <your-master-key>' \
--header 'Content-Type: application/json'

Option 2: Make multiple agents public

curl -X POST 'http://0.0.0.0:4000/v1/agents/make_public' \
--header 'Authorization: Bearer <your-master-key>' \
--header 'Content-Type: application/json' \
--data '{
  "agent_ids": [
    "123e4567-e89b-12d3-a456-426614174000",
    "123e4567-e89b-12d3-a456-426614174001"
  ]
}'

Expected Response

{
  "message": "Successfully updated public agent groups",
  "public_agent_groups": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "updated_by": "user123"
}

3. View public agents

Users can now discover the agent via the public endpoint.

UI

API

curl -X GET 'http://0.0.0.0:4000/public/agent_hub' \
--header 'Authorization: Bearer <user-api-key>'

Expected Response

[
  {
    "protocolVersion": "1.0",
    "name": "Hello World Agent",
    "description": "Just a hello world agent",
    "url": "http://localhost:9999/",
    "version": "1.0.0",
    "defaultInputModes": ["text"],
    "defaultOutputModes": ["text"],
    "capabilities": {
      "streaming": true
    },
    "skills": [
      {
        "id": "hello_world",
        "name": "Returns hello world",
        "description": "just returns hello world",
        "tags": ["hello world"],
        "examples": ["hi", "hello world"]
      }
    ]
  }
]