parent
fbfc3f3cea
commit
7a8fa65f8f
@ -1,75 +1,149 @@
|
||||
|
||||
# Swarm Ecosystem
|
||||
# Swarms Ecosystem
|
||||
|
||||
Welcome to the Swarm Ecosystem, a comprehensive suite of tools and frameworks designed to empower developers to orhestrate swarms of autonomous agents for a variety of applications. Dive into our ecosystem below:
|
||||
*The Complete Enterprise-Grade Multi-Agent AI Platform*
|
||||
|
||||
[Full Github Link](https://github.com/kyegomez/swarm-ecosystem)
|
||||
---
|
||||
|
||||
## **Join the Future of AI Development**
|
||||
|
||||
**We're Building the Operating System for the Agent Economy** - The Swarms ecosystem represents the most comprehensive, production-ready multi-agent AI platform available today. From our flagship Python framework to high-performance Rust implementations and client libraries spanning every major programming language, we provide enterprise-grade tools that power the next generation of intelligent applications.
|
||||
|
||||
---
|
||||
|
||||
## **Complete Product Portfolio**
|
||||
|
||||
| **Product** | **Technology** | **Status** | **Repository** | **Documentation** | **Key Features** | **Use Cases** |
|
||||
|-------------|---------------|------------|----------------|-------------------|------------------|---------------|
|
||||
| **Swarms Python Framework** | Python | **Production** | [swarms](https://github.com/kyegomez/swarms) | [Docs](https://docs.swarms.world/en/latest/swarms/install/install/) | • 20+ Multi-Agent Architectures<br/>• Enterprise Tool Integration<br/>• Production Logging & Monitoring<br/>• LLM Provider Agnostic<br/>• Backwards Compatible | • Complex Business Process Automation<br/>• Financial Analysis & Trading<br/>• Research & Knowledge Work<br/>• Content Creation Pipelines<br/>• Healthcare & Legal Applications |
|
||||
| **Swarms Rust Framework** | Rust | **Production** | [swarms-rs](https://github.com/The-Swarm-Corporation/swarms-rs) | [Docs](https://docs.swarms.world/en/latest/swarms_rs/overview/) | • Ultra-High Performance<br/>• Memory Safety & Zero-Cost Abstractions<br/>• Concurrent Agent Execution<br/>• MCP Protocol Support<br/>• WebAssembly Compatible | • High-Frequency Trading Systems<br/>• Real-Time Data Processing<br/>• Edge Computing Applications<br/>• System-Level Agent Integration<br/>• Performance-Critical Workloads |
|
||||
| **Python API Client** | Python | **Production** | [swarms-sdk](https://github.com/The-Swarm-Corporation/swarms-sdk) | [Docs](https://docs.swarms.world/en/latest/swarms_cloud/python_client/) | • Async/Await Support<br/>• Type-Safe Pydantic Models<br/>• Automatic Retry Logic<br/>• Context Managers<br/>• Rich Logging Integration | • Cloud-Native Applications<br/>• Data Science Workflows<br/>• Machine Learning Pipelines<br/>• Research & Academia<br/>• Enterprise Python Applications |
|
||||
| **TypeScript/Node.js Client** | TypeScript | **Production** | [swarms-ts](https://github.com/The-Swarm-Corporation/swarms-ts) | *Coming Soon* | • Full Type Safety<br/>• Promise-Based API<br/>• Browser & Node.js Compatible<br/>• Zero Dependencies<br/>• Modern ES6+ Support | • Web Applications<br/>• Server-Side Applications<br/>• React/Vue/Angular Integration<br/>• Node.js Microservices<br/>• Full-Stack Development |
|
||||
| **Go Client** | Go | **Production** | [swarms-client-go](https://github.com/The-Swarm-Corporation/swarms-client-go) | *Coming Soon* | • Context Support<br/>• Structured Logging<br/>• Concurrency Safe<br/>• Minimal Memory Allocation<br/>• Built for Microservices | • Cloud Infrastructure<br/>• Kubernetes Applications<br/>• Microservices Architecture<br/>• DevOps Automation<br/>• System Integration |
|
||||
| **Java Client** | Java | **Production** | [swarms-java](https://github.com/The-Swarm-Corporation/swarms-java) | *Coming Soon* | • Spring Boot Integration<br/>• Reactive Streams Support<br/>• Enterprise Features<br/>• Maven Central Available<br/>• JMX Metrics | • Enterprise Java Applications<br/>• Spring Boot Services<br/>• Android Applications<br/>• Banking & Finance Systems<br/>• Large-Scale Enterprise |
|
||||
| **Kotlin Client** | Kotlin | **Q2 2025** | *In Development* | *Coming Soon* | • Coroutines Support<br/>• Android Compatibility<br/>• Interop with Java<br/>• Null Safety<br/>• Modern Language Features | • Android Applications<br/>• JVM Applications<br/>• Mobile Development<br/>• Cross-Platform Solutions<br/>• Modern Java Alternatives |
|
||||
| **Ruby Client** | Ruby | **Q2 2025** | *In Development* | *Coming Soon* | • Rails Integration<br/>• Gem Packaging<br/>• Elegant API Design<br/>• Convention over Configuration<br/>• Ruby Ecosystem Integration | • Ruby on Rails Applications<br/>• Web Development<br/>• Rapid Prototyping<br/>• Startup Applications<br/>• Content Management |
|
||||
| **Rust Client** | Rust | **Q2 2025** | *In Development* | *Coming Soon* | • Memory Safety<br/>• Zero-Cost Abstractions<br/>• WebAssembly Support<br/>• Fearless Concurrency<br/>• System Programming | • System Programming<br/>• WebAssembly Applications<br/>• Performance-Critical Apps<br/>• Blockchain Applications<br/>• Embedded Systems |
|
||||
| **C#/.NET Client** | C# | **Q3 2025** | *In Development* | *Coming Soon* | • Async/Await Support<br/>• NuGet Packaging<br/>• .NET Core & Framework<br/>• LINQ Integration<br/>• Enterprise Features | • Enterprise .NET Applications<br/>• Azure Cloud Services<br/>• Desktop Applications<br/>• Game Development<br/>• Financial Services |
|
||||
|
||||
---
|
||||
|
||||
## **Why Choose the Swarms Ecosystem?**
|
||||
|
||||
### **Enterprise-Grade Architecture**
|
||||
|
||||
- **Production Ready**: Battle-tested in enterprise environments with 99.9%+ uptime
|
||||
|
||||
- **Scalable Infrastructure**: Handle millions of agent interactions with automatic scaling
|
||||
|
||||
- **Security First**: End-to-end encryption, API key management, and enterprise compliance
|
||||
|
||||
- **Observability**: Comprehensive logging, monitoring, and debugging capabilities
|
||||
|
||||
### **Developer Experience**
|
||||
|
||||
- **Multiple Language Support**: Native clients for every major programming language
|
||||
|
||||
## Getting Started
|
||||
- **Unified API**: Consistent interface across all platforms and languages
|
||||
|
||||
| Project | Description | Link |
|
||||
| ------- | ----------- | ---- |
|
||||
| **Swarms Framework** | A Python-based framework that enables the creation, deployment, and scaling of reliable swarms of autonomous agents aimed at automating complex workflows. | [Swarms Framework](https://github.com/kyegomez/swarms) |
|
||||
| **Swarms Cloud** | A cloud-based service offering Swarms-as-a-Service with guaranteed 100% uptime, cutting-edge performance, and enterprise-grade reliability for seamless scaling and management of swarms. | [Swarms Cloud](https://github.com/kyegomez/swarms-cloud) |
|
||||
| **Swarms Core** | Provides backend utilities focusing on concurrency, multi-threading, and advanced execution strategies, developed in Rust for maximum efficiency and performance. | [Swarms Core](https://github.com/kyegomez/swarms-core) |
|
||||
| **Swarm Foundation Models** | A dedicated repository for the creation, optimization, and training of groundbreaking swarming models. Features innovative models like PSO with transformers, ant colony optimizations, and more, aiming to surpass traditional architectures like Transformers and SSMs. Open for community contributions and ideas. | [Swarm Foundation Models](https://github.com/kyegomez/swarms-pytorch) |
|
||||
| **Swarm Platform** | The Swarms dashboard Platform | [Swarm Platform](https://github.com/kyegomez/swarms-platform) |
|
||||
| **Swarms JS** | Swarms Framework in JS. Orchestrate any agents and enable multi-agent collaboration between various agents! | [Swarm JS](https://github.com/kyegomez/swarms-js) |
|
||||
| **Swarms Memory** | Easy to use, reliable, and bleeding-edge RAG systems.! | [Swarm JS](https://github.com/kyegomez/swarms-memory) |
|
||||
| **Swarms Evals** | Evaluating Swarms! | [Swarm JS](https://github.com/kyegomez/swarms-evals) |
|
||||
| **Swarms Zero** | RPC Enterprise-Grade Automation Framework | [Swarm Zero]([https://github.com/kyegomez/swarms-evals](https://github.com/kyegomez/Zero)) |
|
||||
- **Rich Documentation**: Comprehensive guides, tutorials, and API references
|
||||
|
||||
----
|
||||
- **Active Community**: 24/7 support through Discord, GitHub, and direct channels
|
||||
|
||||
## 🫶 Contributions:
|
||||
### **Performance & Reliability**
|
||||
|
||||
The easiest way to contribute is to pick any issue with the `good first issue` tag 💪. Read the Contributing guidelines [here](/CONTRIBUTING.md). Bug Report? [File here](https://github.com/swarms/gateway/issues) | Feature Request? [File here](https://github.com/swarms/gateway/issues)
|
||||
- **High Throughput**: Process thousands of concurrent agent requests
|
||||
|
||||
Swarms is an open-source project, and contributions are VERY welcome. If you want to contribute, you can create new features, fix bugs, or improve the infrastructure. Please refer to the [CONTRIBUTING.md](https://github.com/kyegomez/swarms/blob/master/CONTRIBUTING.md) and our [contributing board](https://github.com/users/kyegomez/projects/1) to participate in Roadmap discussions!
|
||||
- **Low Latency**: Optimized for real-time applications and user experiences
|
||||
|
||||
<a href="https://github.com/kyegomez/swarms/graphs/contributors">
|
||||
<img src="https://contrib.rocks/image?repo=kyegomez/swarms" />
|
||||
</a>
|
||||
- **Fault Tolerance**: Automatic retries, circuit breakers, and graceful degradation
|
||||
|
||||
<a href="https://github.com/kyegomez/swarms/graphs/contributors">
|
||||
<img src="https://contrib.rocks/image?repo=kyegomez/swarms-cloud" />
|
||||
</a>
|
||||
- **Multi-Cloud**: Deploy on AWS, GCP, Azure, or on-premises infrastructure
|
||||
|
||||
<a href="https://github.com/kyegomez/swarms/graphs/contributors">
|
||||
<img src="https://contrib.rocks/image?repo=kyegomez/swarms-platform" />
|
||||
</a>
|
||||
---
|
||||
|
||||
## **Join Our Growing Community**
|
||||
|
||||
### **Connect With Developers Worldwide**
|
||||
|
||||
| **Platform** | **Purpose** | **Join Link** | **Benefits** |
|
||||
|--------------|-------------|---------------|--------------|
|
||||
| **Discord Community** | Real-time support & discussions | [Join Discord](https://discord.gg/jM3Z6M9uMq) | • 24/7 developer support<br/>• Weekly community events<br/>• Direct access to core team<br/>• Beta feature previews |
|
||||
| **Twitter/X** | Latest updates & announcements | [Follow @swarms_corp](https://x.com/swarms_corp) | • Breaking news & updates<br/>• Community highlights<br/>• Technical insights<br/>• Industry partnerships |
|
||||
| **LinkedIn** | Professional network & updates | [The Swarm Corporation](https://www.linkedin.com/company/the-swarm-corporation) | • Professional networking<br/>• Career opportunities<br/>• Enterprise partnerships<br/>• Industry insights |
|
||||
| **YouTube** | Tutorials & technical content | [Swarms Channel](https://www.youtube.com/channel/UC9yXyitkbU_WSy7bd_41SqQ) | • In-depth tutorials<br/>• Live coding sessions<br/>• Architecture deep dives<br/>• Community showcases |
|
||||
|
||||
---
|
||||
|
||||
## **Contribute to the Ecosystem**
|
||||
|
||||
### **How You Can Make an Impact**
|
||||
|
||||
<a href="https://github.com/kyegomez/swarms/graphs/contributors">
|
||||
<img src="https://contrib.rocks/image?repo=kyegomez/swarms-js" />
|
||||
</a>
|
||||
| **Contribution Area** | **Skills Needed** | **Impact Level** | **Getting Started** |
|
||||
|-----------------------|-------------------|------------------|---------------------|
|
||||
| **Core Framework Development** | Python, Rust, Systems Design | **High Impact** | [Contributing Guide](https://docs.swarms.world/en/latest/contributors/main/) |
|
||||
| **Client Library Development** | Various Languages (Go, Java, TS, etc.) | **High Impact** | [Client Development](https://github.com/The-Swarm-Corporation) |
|
||||
| **Documentation & Tutorials** | Technical Writing, Examples | **High Impact** | [Docs Contributing](https://docs.swarms.world/en/latest/contributors/docs/) |
|
||||
| **Testing & Quality Assurance** | Testing Frameworks, QA | **Medium Impact** | [Testing Guide](https://docs.swarms.world/en/latest/swarms/framework/test/) |
|
||||
| **UI/UX & Design** | Design, Frontend Development | **Medium Impact** | [Design Contributions](https://github.com/The-Swarm-Corporation/swarms/issues) |
|
||||
| **Bug Reports & Feature Requests** | User Experience, Testing | **Easy Start** | [Report Issues](https://github.com/The-Swarm-Corporation/swarms/issues) |
|
||||
|
||||
---
|
||||
|
||||
## **We're Hiring Top Talent**
|
||||
|
||||
### **Join the Team Building the Future Of The World Economy**
|
||||
|
||||
**Ready to work on cutting-edge agent technology that's shaping the future?** We're actively recruiting exceptional engineers, researchers, and technical leaders to join our mission of building the operating system for the agent economy.
|
||||
|
||||
----
|
||||
| **Why Join Swarms?** | **What We Offer** |
|
||||
|-----------------------|-------------------|
|
||||
| **Cutting-Edge Technology** | Work on the most powerful multi-agent systems, distributed computing, and enterprise-scale infrastructure |
|
||||
| **Global Impact** | Your code will power agent applications used by Fortune 500 companies and millions of developers |
|
||||
| **World-Class Team** | Collaborate with top engineers, researchers, and industry experts from Google, OpenAI, and more |
|
||||
| **Fast Growth** | Join a rapidly scaling company with massive market opportunity and venture backing |
|
||||
|
||||
## Community
|
||||
### **Open Positions**
|
||||
|
||||
Join our growing community around the world, for real-time support, ideas, and discussions on Swarms 😊
|
||||
| **Position** | **Role Description** |
|
||||
|-------------------------------|----------------------------------------------------------|
|
||||
| **Senior Rust Engineers** | Building high-performance agent infrastructure |
|
||||
| **Python Framework Engineers**| Expanding our core multi-agent capabilities |
|
||||
| **DevOps/Platform Engineers** | Scaling cloud infrastructure for millions of agents |
|
||||
| **Technical Writers** | Creating world-class developer documentation |
|
||||
| **Solutions Engineers** | Helping enterprises adopt multi-agent AI |
|
||||
|
||||
- View our official [Blog](https://docs.swarms.world)
|
||||
- Chat live with us on [Discord](https://discord.gg/kS3rwKs3ZC)
|
||||
- Follow us on [Twitter](https://twitter.com/kyegomez)
|
||||
- Connect with us on [LinkedIn](https://www.linkedin.com/company/the-swarm-corporation)
|
||||
- Visit us on [YouTube](https://www.youtube.com/channel/UC9yXyitkbU_WSy7bd_41SqQ)
|
||||
- [Join the Swarms community on Discord!](https://discord.gg/AJazBmhKnr)
|
||||
- Join our Swarms Community Gathering every Thursday at 1pm NYC Time to unlock the potential of autonomous agents in automating your daily tasks [Sign up here](https://lu.ma/5p2jnc2v)
|
||||
**Ready to Build the Future?** **[Apply Now at swarms.ai/hiring](https://swarms.ai/hiring)**
|
||||
|
||||
---
|
||||
|
||||
---
|
||||
|
||||
## Discovery Call
|
||||
Book a discovery call to learn how Swarms can lower your operating costs by 40% with swarms of autonomous agents in lightspeed. [Click here to book a time that works for you!](https://calendly.com/swarm-corp/30min?month=2023-11)
|
||||
## **Get Started Today**
|
||||
|
||||
### **Quick Start Guide**
|
||||
|
||||
| **Step** | **Action** | **Time Required** |
|
||||
|----------|------------|-------------------|
|
||||
| **1** | [Install Swarms Python Framework](https://docs.swarms.world/en/latest/swarms/install/install/) | 5 minutes |
|
||||
| **2** | [Run Your First Agent](https://docs.swarms.world/en/latest/swarms/examples/basic_agent/) | 10 minutes |
|
||||
| **3** | [Try Multi-Agent Workflows](https://docs.swarms.world/en/latest/swarms/examples/sequential_example/) | 15 minutes |
|
||||
| **4** | [Join Our Discord Community](https://discord.gg/jM3Z6M9uMq) | 2 minutes |
|
||||
| **5** | [Explore Enterprise Features](https://docs.swarms.world/en/latest/swarms_cloud/swarms_api/) | 20 minutes |
|
||||
|
||||
## Accelerate Backlog
|
||||
Help us accelerate our backlog by supporting us financially! Note, we're an open source corporation and so all the revenue we generate is through donations at the moment ;)
|
||||
---
|
||||
|
||||
## **Enterprise Support & Partnerships**
|
||||
|
||||
<a href="https://polar.sh/kyegomez"><img src="https://polar.sh/embed/fund-our-backlog.svg?org=kyegomez" /></a>
|
||||
### **Ready to Scale with Swarms?**
|
||||
|
||||
| **Contact Type** | **Best For** | **Response Time** | **Contact Information** |
|
||||
|------------------|--------------|-------------------|-------------------------|
|
||||
| **Technical Support** | Development questions, troubleshooting | < 24 hours | [Book Support Call](https://cal.com/swarms/swarms-technical-support) |
|
||||
| **Enterprise Sales** | Custom deployments, enterprise licensing | < 4 hours | [kye@swarms.world](mailto:kye@swarms.world) |
|
||||
| **Partnerships** | Integration partnerships, technology alliances | < 48 hours | [kye@swarms.world](mailto:kye@swarms.world) |
|
||||
| **Investor Relations** | Investment opportunities, funding updates | By appointment | [kye@swarms.world](mailto:kye@swarms.world) |
|
||||
|
||||
---
|
||||
|
||||
**Ready to build the future of AI? Start with Swarms today and join thousands of developers creating the next generation of intelligent applications.**
|
||||
|
@ -0,0 +1,384 @@
|
||||
# Technical Support
|
||||
|
||||
*Getting Help with the Swarms Multi-Agent Framework*
|
||||
|
||||
---
|
||||
|
||||
## **Getting Started with Support**
|
||||
|
||||
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 quickly and efficiently.
|
||||
|
||||
---
|
||||
|
||||
## **Support Channels Overview**
|
||||
|
||||
| **Support Type** | **Best For** | **Response Time** | **Channel** |
|
||||
|------------------|--------------|-------------------|-------------|
|
||||
| **Bug Reports** | Code issues, errors, unexpected behavior | < 24 hours | [GitHub Issues](https://github.com/kyegomez/swarms/issues) |
|
||||
| **Feature Requests** | New capabilities, enhancements | < 48 hours | [Email kye@swarms.world](mailto:kye@swarms.world) |
|
||||
| **Private Issues** | Security concerns, enterprise consulting | < 4 hours | [Book Support Call](https://cal.com/swarms/swarms-technical-support?overlayCalendar=true) |
|
||||
| **Real-time Help** | Quick questions, community discussions | Immediate | [Discord Community](https://discord.gg/jM3Z6M9uMq) |
|
||||
| **Documentation** | Usage guides, examples, tutorials | Self-service | [docs.swarms.world](https://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
|
||||
|
||||
- Public technical discussions
|
||||
|
||||
### **How to Create an Effective Bug Report**
|
||||
|
||||
1. **Visit our Issues page**: [https://github.com/kyegomez/swarms/issues](https://github.com/kyegomez/swarms/issues)
|
||||
|
||||
2. **Search existing issues** to avoid duplicates
|
||||
|
||||
3. **Click "New Issue"** and select the appropriate template
|
||||
|
||||
4. **Include the following information**:
|
||||
|
||||
```markdown
|
||||
## 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
|
||||
```python
|
||||
# Minimal code that reproduces the issue
|
||||
from swarms import Agent
|
||||
|
||||
agent = Agent(model_name="gpt-4o-mini")
|
||||
result = agent.run("Your task here")
|
||||
```
|
||||
|
||||
## Error Messages
|
||||
```
|
||||
Paste any error messages or stack traces here
|
||||
```
|
||||
|
||||
## Additional Context
|
||||
Any other context, screenshots, or logs that might help.
|
||||
|
||||
### **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
|
||||
|
||||
- Strategic technical planning
|
||||
|
||||
|
||||
### **How to Schedule Support**
|
||||
|
||||
1. **Visit our booking page**: [https://cal.com/swarms/swarms-technical-support?overlayCalendar=true](https://cal.com/swarms/swarms-technical-support?overlayCalendar=true)
|
||||
|
||||
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
|
||||
|
||||
- Share your use case and goals
|
||||
|
||||
|
||||
### **What to Expect**
|
||||
|
||||
- **Direct access** to Swarms core team members
|
||||
|
||||
- **Screen sharing** for live debugging
|
||||
|
||||
- **Custom solutions** tailored to your needs
|
||||
|
||||
- **Follow-up resources** and documentation
|
||||
|
||||
- **Priority support** for implementation
|
||||
|
||||
|
||||
---
|
||||
|
||||
## **Real-Time Community Support**
|
||||
|
||||
### **Join Our Discord Community**
|
||||
|
||||
Get instant help from our active community of developers and core team members.
|
||||
|
||||
**Discord Benefits:**
|
||||
- **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**
|
||||
|
||||
1. **Join here**: [https://discord.gg/jM3Z6M9uMq](https://discord.gg/jM3Z6M9uMq)
|
||||
|
||||
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]
|
||||
```
|
||||
|
||||
5. **Be patient and respectful** - our community loves helping!
|
||||
|
||||
|
||||
---
|
||||
|
||||
## **Feature Requests & Enhancement Suggestions**
|
||||
|
||||
### **When to Email for Feature Requests**
|
||||
|
||||
Contact us directly for:
|
||||
|
||||
- Major new framework capabilities
|
||||
|
||||
- Architecture enhancements
|
||||
|
||||
- New model provider integrations
|
||||
|
||||
- Enterprise-specific features
|
||||
|
||||
- Analytics and monitoring tools
|
||||
|
||||
- UI/UX improvements
|
||||
|
||||
|
||||
### **How to Submit Feature Requests**
|
||||
|
||||
**Email**: [kye@swarms.world](mailto:kye@swarms.world)
|
||||
|
||||
**Subject Format**: `[FEATURE REQUEST] Brief description`
|
||||
|
||||
**Include in your email**:
|
||||
|
||||
```markdown
|
||||
## Feature Description
|
||||
Clear description of the proposed feature
|
||||
|
||||
## Use Case
|
||||
Why this feature is needed and how it would be used
|
||||
|
||||
## Business Impact
|
||||
How this would benefit the Swarms ecosystem
|
||||
|
||||
## Technical Requirements
|
||||
Any specific technical considerations
|
||||
|
||||
## Priority Level
|
||||
- Low: Nice to have
|
||||
|
||||
- Medium: Would significantly improve workflow
|
||||
|
||||
- High: Critical for adoption/production use
|
||||
|
||||
|
||||
## Alternatives Considered
|
||||
Other solutions you've explored
|
||||
|
||||
## Implementation Ideas
|
||||
Any thoughts on how this could be implemented
|
||||
```
|
||||
|
||||
### **Feature Request Process**
|
||||
|
||||
1. **Email submission** with detailed requirements
|
||||
2. **Initial review** within 48 hours
|
||||
3. **Technical feasibility** assessment
|
||||
4. **Community feedback** gathering (if applicable)
|
||||
5. **Roadmap planning** and timeline estimation
|
||||
6. **Development** and testing
|
||||
7. **Release** with documentation
|
||||
|
||||
---
|
||||
|
||||
## **Self-Service Resources**
|
||||
|
||||
Before reaching out for support, check these resources:
|
||||
|
||||
### **Documentation**
|
||||
|
||||
- **[Complete Documentation](https://docs.swarms.world)** - Comprehensive guides and API reference
|
||||
|
||||
- **[Installation Guide](https://docs.swarms.world/en/latest/swarms/install/install/)** - Setup and configuration
|
||||
|
||||
- **[Quick Start](https://docs.swarms.world/en/latest/quickstart/)** - Get up and running fast
|
||||
|
||||
- **[Examples Gallery](https://docs.swarms.world/en/latest/examples/)** - Real-world use cases
|
||||
|
||||
|
||||
### **Common Solutions**
|
||||
|
||||
| Issue | Solution |
|
||||
|-------|----------|
|
||||
| **Installation fails** | Check [Environment Setup](https://docs.swarms.world/en/latest/swarms/install/env/) |
|
||||
| **Model not responding** | Verify API keys in environment variables |
|
||||
| **Import errors** | Ensure latest version: `pip install -U swarms` |
|
||||
| **Memory issues** | Review [Performance Guide](https://docs.swarms.world/en/latest/swarms/framework/test/) |
|
||||
| **Agent not working** | Check [Basic Agent Example](https://docs.swarms.world/en/latest/swarms/examples/basic_agent/) |
|
||||
|
||||
### **Video Tutorials**
|
||||
|
||||
- **[YouTube Channel](https://www.youtube.com/channel/UC9yXyitkbU_WSy7bd_41SqQ)** - Step-by-step tutorials
|
||||
|
||||
- **[Live Coding Sessions](https://www.youtube.com/channel/UC9yXyitkbU_WSy7bd_41SqQ)** - Real-world implementations
|
||||
|
||||
|
||||
---
|
||||
|
||||
## **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)
|
||||
|
||||
|
||||
---
|
||||
|
||||
## **Support Best Practices**
|
||||
|
||||
### **For Faster Resolution**
|
||||
|
||||
1. **Be Specific**: Provide exact error messages and steps to reproduce
|
||||
2. **Include Code**: Share minimal, runnable examples
|
||||
3. **Environment Details**: Always include version information
|
||||
4. **Search First**: Check if your issue has been addressed before
|
||||
5. **One Issue Per Report**: Don't combine multiple problems
|
||||
6. **Follow Up**: Respond promptly to requests for additional information
|
||||
|
||||
### **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 |
|
||||
|
||||
---
|
||||
|
||||
## **Contributing Back**
|
||||
|
||||
Help improve support for everyone:
|
||||
|
||||
- **Answer questions** in Discord or GitHub
|
||||
|
||||
- **Improve documentation** with your learnings
|
||||
|
||||
- **Share examples** of successful implementations
|
||||
|
||||
- **Report bugs** you discover
|
||||
|
||||
- **Suggest improvements** to this support process
|
||||
|
||||
|
||||
**Your contributions make Swarms better for everyone.**
|
||||
|
||||
---
|
||||
|
||||
## **Support Channel Summary**
|
||||
|
||||
| Urgency | Best Channel |
|
||||
|---------|-------------|
|
||||
| **Emergency** | [Book Immediate Call](https://cal.com/swarms/swarms-technical-support?overlayCalendar=true) |
|
||||
| **Urgent** | [Discord #technical-support](https://discord.gg/jM3Z6M9uMq) |
|
||||
| **Standard** | [GitHub Issues](https://github.com/kyegomez/swarms/issues) |
|
||||
| **Feature Ideas** | [Email kye@swarms.world](mailto:kye@swarms.world) |
|
||||
|
||||
**We're here to help you succeed with Swarms.**
|
Loading…
Reference in new issue