ayaiay Catalog

The ayaiay Catalog is a web-based platform for discovering, exploring, and managing AI agent packs, instructions, prompts, and MCP servers.

What is the Catalog?

The catalog serves as the central hub of the ayaiay ecosystem, providing:

• Discovery: Search and browse thousands of AI resources
• Exploration: View detailed information about packs and their contents
• Management: Publish and manage your own packs
• Community: Connect with publishers and users

Key Features

Search and Discovery

• Powerful Search: Find packs by name, description, or publisher
• Advanced Filters: Filter by pack type, visibility, and more
• Sorting Options: Sort by popularity, recent updates, or name
• Quick Preview: See pack contents without installing

Statistics and Insights

The catalog tracks and displays:

• Total packs and versions
• Number of publishers
• Content items (agents, instructions, prompts, MCP servers)
• Popular and trending packs

User Profiles

Registered users can:

• Create publisher profiles
• Upload and manage packs
• Track pack versions
• View analytics and usage

Visibility Control

Packs can have different visibility levels:

• Public: Visible to everyone
• Private: Only visible to the owner
• Organization: Shared within an organization

How It Works

1. Browsing Packs

Visit ayaiay.org/explore to browse all public packs:

• Use the search bar to find specific packs
• Click on any pack to view its details
• View agents, instructions, prompts, and MCP servers
• Check version history and changelogs

2. Viewing Pack Details

Each pack page shows:

• Overview: Description, publisher, and metadata
• Versions: All available versions with changelogs
• Contents: Lists of agents, instructions, prompts, and MCP servers
• Installation: Commands to install via CLI
• Repository: Link to the source code on GitHub

3. User Dashboard

Registered users have access to a dashboard at ayaiay.org/dashboard:

• My Packs: View and manage your published packs
• Publishers: Manage your publisher profiles
• Statistics: Track views and installations
• Import: Import packs from GitHub repositories

Pack Types

The catalog supports four main types of resources:

Agents

AI agent profiles with:

• Display name and description
• System instructions path
• Model configuration (provider, model name, parameters)
• Optional avatar and metadata

Instructions

Detailed guidelines stored as Markdown:

• Task-specific instructions
• Behavioral guidelines
• Quality standards and best practices
• Workflow definitions

Prompts

Reusable prompt templates with:

• Template content with variable placeholders
• Variable definitions and types
• Example inputs and outputs
• Tags and categories

MCP Servers

Model Context Protocol servers with:

• Server metadata and configuration
• Available tools and their schemas
• Resources and prompts
• Authentication and transport settings

Publishing to the Catalog

To publish your pack to the catalog:

1. Create a Publisher Profile: Register and create a publisher identity
2. Prepare Your Pack: Ensure your pack has a valid ayaiay.yaml manifest
3. Push to GitHub: Host your pack in a GitHub repository with tags for versions
4. Import to Catalog: Use the dashboard to import your pack from GitHub
5. Publish Version: Select which version to make publicly available

👉 Detailed Publishing Guide

REST API

The catalog provides a REST API for programmatic access:

Endpoints

• GET /api/v1/packs - List all packs
• GET /api/v1/packs/{id} - Get pack details
• GET /api/v1/packs/{id}/versions - Get version history
• GET /api/v1/packs/{id}/versions/{version} - Get specific version
• POST /api/v1/packs/import - Import pack from GitHub
• GET /api/v1/packs/stats - Get platform statistics

Authentication

The catalog supports two authentication modes:

• Interactive user login (for dashboard usage in the browser)
• ayaiay OAuth clients (for bots and machine-to-machine API integrations)

For bot integrations, ayaiay provides OAuth 2.0 Client Credentials:

• Create OAuth client credentials in your publisher dashboard
• Request bearer tokens via /oauth/token
• Use scoped tokens for authenticated API requests
• Rate limiting applies to all endpoints

👉 Full API Reference

Best Practices

For Pack Users

• Check Versions: Always review the version history before installing
• Read Documentation: Review pack contents and documentation
• Verify Publishers: Use packs from trusted publishers
• Report Issues: Use GitHub issues to report problems

For Pack Publishers

• Use Semantic Versioning: Follow semver for version numbers
• Write Clear Descriptions: Help users understand your pack's purpose
• Maintain Changelogs: Document changes between versions
• Keep Packs Updated: Respond to issues and update regularly
• Add Examples: Provide usage examples and documentation

Security and Privacy

• Open Source: All packs are linked to public GitHub repositories
• Code Review: Users can inspect pack contents before installation
• Sandboxing: Consider running packs in isolated environments
• Access Control: Private packs are only accessible to authorized users
• Data Privacy: No personal data is stored in pack contents

Next Steps

• Browse the Catalog - Start discovering packs
• Using the Web UI - Detailed UI guide
• API Reference - Integrate with the API
• Create Your First Pack - Become a publisher