Skip to main content
Integrate with the Swarms Marketplace to discover, load, and share production-ready prompts, agents, and tools. The marketplace enables seamless integration between your code and the Swarms community ecosystem.

​
What You’ll Learn

TopicDescription
Loading PromptsFetch and use prompts from the marketplace with one line of code
Publishing AgentsShare your agents with the community and monetize your creations
Marketplace DiscoveryBrowse and discover community-created prompts, agents, and tools
API IntegrationProgrammatically interact with the marketplace

​
Marketplace Integration

The Swarms Marketplace (https://swarms.world) is a community hub where developers share and discover:
  • 🤖 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

​
Key Features

FeatureDescription
One-Line Prompt LoadingLoad marketplace prompts directly into agents using marketplace_prompt_id
Direct PublishingPublish agents to the marketplace with minimal configuration
Automatic IntegrationSeamlessly integrates with marketplace API
Monetization ReadySet pricing for your shared agents and prompts
Community DiscoveryBrowse and discover community-created resources

​
Marketplace Examples

​
Loading Prompts from Marketplace

ExampleDescriptionLink
Loading PromptsLoad production-ready prompts from the marketplace into your agentsView Tutorial
Quick Example: 
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-4o-mini",
    marketplace_prompt_id="75fc0d28-b0d0-4372-bc04-824aa388b7d2",  # From URL or metadata section
    max_loops=1,
)

response = agent.run("Your task here")
Finding Prompt IDs: The prompt ID is the UUID found in the marketplace URL (e.g., https://swarms.world/prompt/75fc0d28-b0d0-4372-bc04-824aa388b7d2) or in the Metadata section of the prompt listing page.

​
Publishing to Marketplace

ExampleDescriptionLink
Agent PublishingPublish your agents to the marketplace for community useView Tutorial
Quick Example: 
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-4o-mini",
    publish_to_marketplace=True,  # Enable publishing
    # ... additional configuration
)

​
Prerequisites

Before using marketplace features, ensure you have:
  1. Swarms installed:
pip install -U swarms
  1. A Swarms API key - Get yours at https://swarms.world/platform/api-keys
  2. Set your API key as an environment variable: 
export SWARMS_API_KEY="your-api-key-here"

​
How It Works

​
Loading Prompts

When you provide a marketplace_prompt_id to an agent:
  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

When you publish an agent to the marketplace:
  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

​
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