# Guides

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

## Generation Length Blog
- [longform_generator.py](generation_length_blog/longform_generator.py) - Long-form content generation
- [universal_api.py](generation_length_blog/universal_api.py) - Universal API implementation

## Geo Guesser Agent
- [geo_guesser_agent.py](geo_guesser_agent/geo_guesser_agent.py) - Geographic location guessing agent
- [miami.jpg](geo_guesser_agent/miami.jpg) - Sample Miami image
- [README.md](geo_guesser_agent/README.md) - Geo guesser documentation

## Graph Workflow Guide
- [comprehensive_demo.py](graphworkflow_guide/comprehensive_demo.py) - Comprehensive graph workflow demo
- [GETTING_STARTED.md](graphworkflow_guide/GETTING_STARTED.md) - Getting started guide
- [graph_workflow_technical_guide.md](graphworkflow_guide/graph_workflow_technical_guide.md) - Technical documentation
- [quick_start_guide.py](graphworkflow_guide/quick_start_guide.py) - Quick start implementation
- [README.md](graphworkflow_guide/README.md) - Main documentation
- [setup_and_test.py](graphworkflow_guide/setup_and_test.py) - Setup and testing utilities

## Hierarchical Marketing Team
- [hiearchical_marketing_team.py](hiearchical_marketing_team.py) - Marketing team hierarchy example

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

## Smart Database
- [README.md](smart_database/README.md) - Smart database documentation

## Changelog Examples

### 840 Update
- [agent_rearrange_concurrent_example.py](840_update/agent_rearrange_concurrent_example.py) - Agent rearrange with concurrent execution
- [auto_swarm_builder_example.py](840_update/auto_swarm_builder_example.py) - Auto swarm builder example
- [fallback_example.py](840_update/fallback_example.py) - Fallback mechanism example
- [server.py](840_update/server.py) - Server implementation
- [README.md](840_update/README.md) - 840 update documentation

### 850 Workshop
- [aop_raw_client_code.py](850_workshop/aop_raw_client_code.py) - AOP raw client implementation
- [aop_raw_task_example.py](850_workshop/aop_raw_task_example.py) - AOP raw task example
- [moa_seq_example.py](850_workshop/moa_seq_example.py) - MOA sequential example
- [peer_review_example.py](850_workshop/peer_review_example.py) - Peer review example
- [test_agent_concurrent.py](850_workshop/test_agent_concurrent.py) - Concurrent agent testing
- [uvloop_example.py](850_workshop/uvloop_example.py) - UVLoop integration example
- [server.py](850_workshop/server.py) - Server implementation
- [README.md](850_workshop/README.md) - 850 workshop documentation

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

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

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

## Fairy Swarm
- [fairy_swarm.py](fairy_swarm/fairy_swarm.py) - Fairy swarm implementation
- [fairy_swarm_examples/](fairy_swarm/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/fairy_swarm_examples/README.md) - Fairy swarm examples documentation

## Mem0 Integration
- [mem0_and_swarms.py](mem0/mem0_and_swarms.py) - Mem0 memory management integration with Swarms

## Voice Agents
- [voice_agents/](voice_agents/) - Voice agent examples with speech capabilities

## Web Scraper Agents
- [batched_scraper_agent.py](web_scraper_agents/batched_scraper_agent.py) - Batch web scraping agent
- [web_scraper_agent.py](web_scraper_agents/web_scraper_agent.py) - Basic web scraping agent
- [README.md](web_scraper_agents/README.md) - Web scraper agents documentation

## Deployment
- [deployment/](deployment/) - Deployment strategies and patterns
- [README.md](deployment/README.md) - Deployment documentation
- [fastapi/](deployment/fastapi/) - FastAPI deployment examples
- [cron_job_examples/](deployment/cron_job_examples/) - Cron job examples

## V9 Examples (Autonomous Looper)
- [autonomous_looper.py](v9_examples/autonomous_looper.py) - Autonomous looper implementation
- [example_autonomous_looper_tools.py](v9_examples/example_autonomous_looper_tools.py) - Configuring selected tools
- [example_sub_agents.py](v9_examples/example_sub_agents.py) - Sub-agent creation and delegation