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:
- Create a Publisher Profile: Register and create a publisher identity
- Prepare Your Pack: Ensure your pack has a valid
ayaiay.yamlmanifest - Push to GitHub: Host your pack in a GitHub repository with tags for versions
- Import to Catalog: Use the dashboard to import your pack from GitHub
- 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 packsGET /api/v1/packs/{id}- Get pack detailsGET /api/v1/packs/{id}/versions- Get version historyGET /api/v1/packs/{id}/versions/{version}- Get specific versionPOST /api/v1/packs/import- Import pack from GitHubGET /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