guides

Guides

This directory contains comprehensive guides and tutorials for using Swarms effectively.

AgentSH Implementation

• agentsh.py - Self-organized multi-agent harness with no orchestrator (Agensh, arXiv:2609.26781)
• README.md - How the implementation works

Generation Length Blog

• longform_generator.py - Long-form content generation
• universal_api.py - Universal API implementation

Geo Guesser Agent

• geo_guesser_agent.py - Geographic location guessing agent
• miami.jpg - Sample Miami image
• README.md - Geo guesser documentation

Graph Workflow Guide

• comprehensive_demo.py - Comprehensive graph workflow demo
• GETTING_STARTED.md - Getting started guide
• graph_workflow_technical_guide.md - Technical documentation
• quick_start_guide.py - Quick start implementation
• README.md - Main documentation
• setup_and_test.py - Setup and testing utilities

Hierarchical Marketing Team

• hiearchical_marketing_team.py - Marketing team hierarchy example

Nano Banana Jarvis Agent

• img_gen_nano_banana.py - Image generation with Nano Banana
• jarvis_agent.py - Jarvis AI assistant implementation
• image.jpg - Sample image
• building.jpg - Building image
• hk.jpg - Hong Kong image
• miami.jpg - Miami image
• annotated_images/ - Collection of annotated images for training/testing

Smart Database

• README.md - Smart database documentation

Changelog Examples

840 Update

• agent_rearrange_concurrent_example.py - Agent rearrange with concurrent execution
• auto_swarm_builder_example.py - Auto swarm builder example
• fallback_example.py - Fallback mechanism example
• server.py - Server implementation
• README.md - 840 update documentation

850 Workshop

• moa_seq_example.py - MOA sequential example
• peer_review_example.py - Peer review example
• test_agent_concurrent.py - Concurrent agent testing
• uvloop_example.py - UVLoop integration example
• server.py - Server implementation
• README.md - 850 workshop documentation

880 Update Changelog

• 01_marketplace_prompt_fetching.py - Marketplace prompt fetching
• 02_round_robin_swarm_routing.py - Round robin swarm routing
• 03_graph_workflow_rustworkx.py - Graph workflow with RustWorkX
• 04_agent_rearrange.py - Agent rearrange example
• 05_nested_swarms.py - Nested swarms in an AgentRearrange flow
• 06_spreadsheet_swarm.py - Spreadsheet swarm example
• 07_model_router.py - Model router example
• 08_self_moa_seq.py - Self MOA sequential example
• 09_single_voice_agent.py - Single voice agent
• 10_multi_agent_voice_debate.py - Multi-agent voice debate
• 11_hierarchical_voice_swarm.py - Hierarchical voice swarm
• 12_debate_with_judge.py - Debate with judge evaluation
• 13_council_as_judge.py - Council as judge example
• 14_swarm_router_round_robin.py - Swarm router round robin
• 15_graph_workflow_batch_agents.py - Graph workflow with batch agents
• autosaving_example.py - Autosaving example
• README.md - 880 update documentation

890 Changelog (January 2026)

• 01_dynamic_skills_loader.py - Dynamic skills loader integration
• 02_autonomous_agent_loop.py - Autonomous agent loop architecture
• 03_agent_handoffs.py - Enhanced function calling for agent handoffs
• 04_api_key_validation.py - API key validation system
• 05_max_loops_parameter.py - Max loops parameter refactoring
• 06_multi_tool_agent_tutorial.py - Multi-tool agent tutorial with X402
• 07_hierarchical_voice_agent.py - Hierarchical voice agent
• 08_agent_rearrange_patterns.py - Agent rearrange patterns
• README.md - 890 changelog documentation

Demos

• demos/ - Various demonstration examples including apps, crypto, finance, insurance, legal, medical, real estate, science, and synthetic data
• README.md - Demos documentation

Fairy Swarm

• fairy_swarm.py - Fairy swarm implementation
• fairy_swarm_examples/ - Fairy swarm examples including basic, analytical research, custom fairies, multi-page wireframe, selected fairies, standalone tools, and custom tools
• README.md - Fairy swarm examples documentation

Mem0 Integration

• mem0_and_swarms.py - Mem0 memory management integration with Swarms

Voice Agents

• voice_agents/ - Voice agent examples with speech capabilities

Web Scraper Agents

• batched_scraper_agent.py - Batch web scraping agent
• web_scraper_agent.py - Basic web scraping agent
• README.md - Web scraper agents documentation

Deployment

• deployment/ - Deployment strategies and patterns
• README.md - Deployment documentation
• fastapi/ - FastAPI deployment examples
• cron_job_examples/ - Cron job examples

V9 Examples (Autonomous Looper)

• autonomous_looper.py - Autonomous looper implementation
• example_autonomous_looper_tools.py - Configuring selected tools
• example_sub_agents.py - Sub-agent creation and delegation