Marketplace Examples Overview

​

What You’ll Learn

​

Marketplace Integration

• 🤖 Agents: Ready-to-use agents for specific tasks and industries
• 💡 Prompts: Production-ready system prompts for various use cases
• 🛠️ Tools: APIs, integrations, and utilities that extend agent capabilities
• 📦 Bundles: Curated collections of agents, prompts, and custom prompts packaged into a single toolkit

​

Key Features

​

Marketplace Examples

​

Loading Prompts from Marketplace

from swarms import Agent

# Load a prompt from the marketplace
# The prompt ID is found in the URL: https://swarms.world/prompt/{prompt-id}
agent = Agent(
    model_name="gpt-4.1-mini",
    marketplace_prompt_id="75fc0d28-b0d0-4372-bc04-824aa388b7d2",  # From URL or metadata section
    max_loops=1,
)

response = agent.run("Your task here")

​

Publishing to Marketplace

from swarms import Agent

# Create and publish an agent
agent = Agent(
    agent_name="My-Specialized-Agent",
    agent_description="Expert agent for specific tasks",
    model_name="gpt-4.1-mini",
    publish_to_marketplace=True,  # Enable publishing
    # ... additional configuration
)

​

Prerequisites

1. Swarms installed:

pip install -U swarms

2. A Swarms API key - Get yours at https://swarms.world/platform/api-keys
3. Set your API key as an environment variable:

export SWARMS_API_KEY="your-api-key-here"

​

How It Works

​

Loading Prompts

1. Fetches the prompt from the Swarms Marketplace API during initialization
2. Sets the system prompt from the marketplace data
3. Optionally updates agent metadata - Agent name and description are populated from marketplace data if not set
4. Logs the operation - Confirmation message when prompt is loaded successfully

​

Publishing Agents

1. Validates configuration - Ensures required fields are present
2. Uploads to marketplace - Sends agent configuration to marketplace API
3. Generates marketplace listing - Creates a discoverable listing on swarms.world
4. Enables monetization - Optional pricing configuration for your agent

​

Use Cases

​

For Consumers

• Rapid Prototyping: Quickly test different prompts without manual copy-pasting
• Best Practices: Use community-validated prompts for production systems
• Discovery: Find specialized agents for specific industries or tasks
• Learning: Study how others structure their agents and prompts

​

For Publishers

• Community Contribution: Share your expertise with the Swarms community
• Monetization: Earn revenue from your agent creations
• Visibility: Get your agents discovered by developers worldwide
• Collaboration: Build on top of community-created resources

​

Related Resources

• Swarms Marketplace Platform - Marketplace overview and features
• Share and Discover - Marketplace browsing guide
• Monetization Guide - How to monetize your agents
• API Key Management - Managing your API keys
• Agent Reference - Full agent documentation

​

Next Steps

1. Get Started: Load your first marketplace prompt
2. Publish: Share your agent with the community
3. Explore: Browse the marketplace
4. Learn More: Marketplace platform documentation