swarms/examples

Swarms Examples

This directory contains comprehensive examples demonstrating various capabilities and use cases of the Swarms framework. Each subdirectory focuses on specific aspects of multi-agent systems, single agents, tools, and integrations.

📁 Directory Overview

🤖 Multi-Agent Systems

• multi_agent/ - Advanced multi-agent patterns including agent rearrangement, auto swarm builder (ASB), batched workflows, board of directors, caching, concurrent processing, councils, debates, elections, forest swarms, graph workflows, group chats, heavy swarms, hierarchical swarms, majority voting, orchestration examples, social algorithms, simulations, spreadsheet examples, and swarm routing.

👤 Single Agent Systems

• single_agent/ - Single agent implementations including demos, external agent integrations, LLM integrations (Azure, Claude, DeepSeek, Mistral, OpenAI, Qwen), onboarding, RAG, reasoning agents, tools integration, utils, and vision capabilities.

🛠️ Tools & Integrations

• tools/ - Tool integration examples including agent-as-tools, base tool implementations, browser automation, Claude integration, Exa search, Firecrawl, multi-tool usage, and Stagehand integration.

🎯 Model Integrations

• models/ - Various model integrations including Cerebras, GPT-5, GPT-OSS, Llama 4, Lumo, Ollama, and VLLM implementations with concurrent processing examples and provider-specific configurations.

🔌 API & Protocols

• swarms_api_examples/ - Swarms API usage examples including agent overview, batch processing, client integration, team examples, analysis, and rate limiting.

• mcp/ - Model Context Protocol (MCP) integration examples including agent implementations, multi-connection setups, server configurations, and utility functions.

• aop_examples/ - Agents over Protocol (AOP) examples demonstrating MCP server setup, agent discovery, client interactions, queue-based task submission, and medical AOP implementations.

🧠 Advanced Capabilities

• reasoning_agents/ - Advanced reasoning capabilities including agent judge evaluation systems, O3 model integration, and mixture of agents (MOA) sequential examples.

• rag/ - Retrieval Augmented Generation (RAG) implementations with vector database integrations including Qdrant examples.

📚 Guides & Tutorials

• guides/ - Comprehensive guides and tutorials including generation length blog, geo guesser agent, graph workflow guide, hierarchical marketing team, nano banana Jarvis agent, smart database, web scraper agents, and workshop examples (840_update, 850_workshop).

🎪 Demonstrations

• demos/ - Domain-specific demonstrations across various industries including apps, charts, crypto, CUDA, finance, hackathon projects, insurance, legal, medical, news, privacy, real estate, science, and synthetic data generation.

🏆 Hackathons

• hackathons/ - Hackathon projects and implementations including September 27 hackathon examples with diet coach agents, nutritional content analysis swarms, and API client integrations.

🚀 Deployment

• deployment/ - Deployment strategies and patterns including cron job implementations and FastAPI deployment examples.

🛠️ Utilities

• utils/ - Utility functions and helper implementations including agent loader, communication examples, concurrent wrappers, miscellaneous utilities, and telemetry.

🎓 Educational

• workshops/ - Workshop examples and educational sessions including agent tools, batched grids, geo guesser, and Jarvis agent implementations.

🖥️ User Interface

• ui/ - User interface examples and implementations including chat interfaces.

🚀 Quick Start

1. New to Swarms? Start with single_agent/simple_agent.py for basic concepts
2. Want multi-agent workflows? Check out multi_agent/duo_agent.py
3. Need tool integration? Explore tools/agent_as_tools.py
4. Interested in AOP? Try aop_examples/example_new_agent_tools.py for agent discovery
5. Want to see social algorithms? Check out multi_agent/social_algorithms_examples/
6. Looking for guides? Visit guides/ for comprehensive tutorials
7. Hackathon projects? Explore hackathons/hackathon_sep_27/ for real-world implementations

📖 Documentation

Each subdirectory contains its own README.md file with detailed descriptions and links to all available examples. Click on any folder above to explore its specific examples and use cases.

🔗 Related Resources

• Main Swarms Documentation
• API Reference
• Contributing Guidelines

💡 Contributing

Found an interesting example or want to add your own? Check out our contributing guidelines and feel free to submit pull requests with new examples or improvements to existing ones.

---

This examples directory is continuously updated with new patterns, integrations, and use cases. Check back regularly for the latest examples!