Skip to main content
The Swarms team is committed to providing exceptional technical support to help you build production-grade multi-agent systems. Whether you’re experiencing bugs, need implementation guidance, or want to request new features, we have multiple channels to ensure you get the help you need.

​
Support Channels Overview

Support TypeBest ForResponse TimeChannel
Bug ReportsCode issues, errors, unexpected behavior< 24 hoursGitHub Issues
Major Features (SIPs)New agent types, core changes, integrations1-2 weeksSIP Guidelines
Minor FeaturesSmall enhancements, straightforward additions< 48 hoursGitHub Issues
Private IssuesSecurity concerns, enterprise consulting< 4 hoursBook Support Call
Real-time HelpQuick questions, community discussionsImmediateDiscord Community
DocumentationUsage guides, examples, tutorialsSelf-servicedocs.swarms.world

​
Reporting Bugs & Technical Issues

​
When to Use GitHub Issues

Use GitHub Issues for:
  • Code bugs and errors
  • Installation problems
  • Documentation issues
  • Performance problems
  • API inconsistencies

​
How to Create an Effective Bug Report

  1. Visit the Issues page
  2. Search existing issues to avoid duplicates
  3. Click “New Issue” and select the appropriate template
  4. Include the following information:
## Bug Description
A clear description of what the bug is.

## Environment
- Swarms version: [e.g., 5.9.2]
- Python version: [e.g., 3.9.0]
- Operating System: [e.g., Ubuntu 20.04, macOS 14, Windows 11]
- Model provider: [e.g., OpenAI, Anthropic, Groq]

## Steps to Reproduce
1. Step one
2. Step two
3. Step three

## Expected Behavior
What you expected to happen.

## Actual Behavior
What actually happened.

## Code Sample
[Minimal code that reproduces the issue]

## Error Messages
[Paste any error messages or stack traces]

​
Issue Templates Available

TemplateUse Case
Bug ReportStandard bug reporting template
DocumentationIssues with docs, guides, examples
Feature RequestSuggesting new functionality
QuestionGeneral questions about usage
EnterpriseEnterprise-specific issues

​
Private & Enterprise Support

​
When to Book a Private Support Call

Book a private consultation for:
  • Security vulnerabilities or concerns
  • Enterprise deployment guidance
  • Custom implementation consulting
  • Architecture review sessions
  • Performance optimization
  • Integration troubleshooting

​
How to Schedule Support

  1. Visit the booking page
  2. Select an available time that works for your timezone
  3. Provide details about your issue or requirements
  4. Prepare for the call:
    • Have your code/environment ready
    • Prepare specific questions
    • Include relevant error messages or logs

​
Real-Time Community Support

​
Join Our Discord Community

Get instant help from our active community of developers and core team members.
  • 24/7 availability — someone is always online
  • Instant responses — get help in real-time
  • Community wisdom — learn from other developers
  • Specialized channels — find the right help quickly
  • Latest updates — stay informed about new releases

​
Discord Channels Guide

ChannelPurpose
#generalGeneral discussions and introductions
#technical-supportTechnical questions and troubleshooting
#showcaseShare your Swarms projects and demos
#feature-requestsDiscuss potential new features
#announcementsOfficial updates and releases
#resourcesHelpful links, tutorials, and guides

​
Getting Help on Discord

  1. Join here
  2. Read the rules and introduce yourself in #general
  3. Use the right channel for your question type
  4. Provide context when asking questions: 
    Python version: 3.9
Swarms version: 5.9.2
OS: macOS 14
Question: How do I implement custom tools with MCP?
What I tried: [paste your code]
Error: [paste error message]

​
Feature Requests

​
Swarms Improvement Proposals (SIPs)

The primary way to propose new features and significant enhancements is through the SIP process. When to Submit a SIP:
  • New agent types or behaviors
  • Core framework changes
  • New integrations with external services
  • Breaking changes
  • Complex features requiring community discussion

​
Other Feature Requests

For smaller enhancements that don’t require a full SIP:
  • Visit GitHub Issues and select the “Feature Request” template
  • Provide detailed description and use cases
  • For enterprise-specific features, contact kye@swarms.world

​
Self-Service Resources

Before reaching out for support, check these resources:
ResourceLink
Complete Documentationdocs.swarms.world
Installation GuideInstallation
Quick StartQuickstart
Examples GalleryExamples

​
Common Solutions

IssueSolution
Installation failsCheck Environment Setup
Model not respondingVerify API keys in environment variables
Import errorsEnsure latest version: pip install -U swarms
Agent not workingCheck Basic Agent Example

​
Support Checklist

Before requesting support, please:
  • Check the documentation for existing solutions
  • Search GitHub issues for similar problems
  • Update to latest version: pip install -U swarms
  • Verify environment setup and API keys
  • Test with minimal code to isolate the issue
  • Gather error messages and relevant logs
  • Note your environment (OS, Python version, Swarms version)

​
Response Time Expectations

PriorityResponse TimeResolution Time
Critical (Production down)< 2 hours< 24 hours
High (Major functionality blocked)< 8 hours< 48 hours
Medium (Feature issues)< 24 hours< 1 week
Low (Documentation, enhancements)< 48 hoursNext release

​
Support Channel Summary

UrgencyBest Channel
EmergencyBook Immediate Call
UrgentDiscord #technical-support
StandardGitHub Issues
Major FeaturesSIP Guidelines
Minor FeaturesGitHub Issues