Documentation Index
Fetch the complete documentation index at: https://docs.swarms.world/llms.txt
Use this file to discover all available pages before exploring further.
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 Type | Best For | Response Time | Channel |
|---|
| Bug Reports | Code issues, errors, unexpected behavior | < 24 hours | GitHub Issues |
| Major Features (SIPs) | New agent types, core changes, integrations | 1-2 weeks | SIP Guidelines |
| Minor Features | Small enhancements, straightforward additions | < 48 hours | GitHub Issues |
| Private Issues | Security concerns, enterprise consulting | < 4 hours | Book Support Call |
| Real-time Help | Quick questions, community discussions | Immediate | Discord Community |
| Documentation | Usage guides, examples, tutorials | Self-service | docs.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
- Visit the Issues page
- Search existing issues to avoid duplicates
- Click “New Issue” and select the appropriate template
- 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
| Template | Use Case |
|---|
| Bug Report | Standard bug reporting template |
| Documentation | Issues with docs, guides, examples |
| Feature Request | Suggesting new functionality |
| Question | General questions about usage |
| Enterprise | Enterprise-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
- Visit the booking page
- Select an available time that works for your timezone
- Provide details about your issue or requirements
- Prepare for the call:
- Have your code/environment ready
- Prepare specific questions
- Include relevant error messages or logs
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
| Channel | Purpose |
|---|
| #general | General discussions and introductions |
| #technical-support | Technical questions and troubleshooting |
| #showcase | Share your Swarms projects and demos |
| #feature-requests | Discuss potential new features |
| #announcements | Official updates and releases |
| #resources | Helpful links, tutorials, and guides |
Getting Help on Discord
- Join here
- Read the rules and introduce yourself in #general
- Use the right channel for your question type
- 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:
| Resource | Link |
|---|
| Complete Documentation | docs.swarms.world |
| Installation Guide | Installation |
| Quick Start | Quickstart |
| Examples Gallery | Examples |
Common Solutions
| Issue | Solution |
|---|
| Installation fails | Check Environment Setup |
| Model not responding | Verify API keys in environment variables |
| Import errors | Ensure latest version: pip install -U swarms |
| Agent not working | Check Basic Agent Example |
Support Checklist
Before requesting support, please:
Response Time Expectations
| Priority | Response Time | Resolution 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 hours | Next release |
Support Channel Summary
