swarms/examples/multi_agent/README.md

Multi-Agent Examples

This directory contains comprehensive examples demonstrating various multi-agent patterns and workflows in Swarms.

Agent Rearrangement

• rearrange_test.py - Test agent rearrangement functionality

Auto Swarm Builder (ASB)

• agents_builder.py - Core agent builder functionality
• asb_research.py - Research-focused ASB implementation
• auto_agent.py - Automated agent creation
• auto_swarm_builder_example.py - Complete ASB example
• auto_swarm_builder_test.py - ASB testing suite
• auto_swarm_router.py - Router for auto-generated swarms
• content_creation_asb.py - Content creation with ASB

Batched Grid Workflow

• batched_grid_advanced_example.py - Advanced batched grid workflow
• batched_grid_simple_example.py - Simple batched grid example
• batched_grid_swarm_router.py - Router for batched grid swarms
• batched_grid_workflow_example.py - Complete workflow example
• README.md - Detailed documentation

Board of Directors

• board_of_directors_example.py - Full board simulation
• minimal_board_example.py - Minimal board setup
• simple_board_example.py - Simple board example

Caching Examples

• example_multi_agent_caching.py - Multi-agent caching implementation
• quick_start_agent_caching.py - Quick start guide for caching
• test_simple_agent_caching.py - Simple caching tests

Concurrent Examples

• asi.py - ASI (Artificial Super Intelligence) example
• concurrent_example_dashboard.py - Dashboard for concurrent workflows
• concurrent_example.py - Basic concurrent execution
• concurrent_mix.py - Mixed concurrent patterns
• concurrent_swarm_example.py - Concurrent swarm execution
• streaming_concurrent_workflow.py - Streaming with concurrency
• streaming_callback/ - Streaming callback examples
• uvloop/ - UVLoop integration examples

Council of Judges

• council_judge_evaluation.py - Judge evaluation system
• council_judge_example.py - Basic council example
• council_of_judges_eval.py - Evaluation framework
• council_judge_complex_example.py - Complex council setup
• council_judge_custom_example.py - Custom council configuration

Debate Examples

• debate_examples/ - Various debate simulation patterns

Election Swarm

• apple_board_election_example.py - Apple board election simulation
• election_example.py - General election example

Forest Swarm

• forest_swarm_example.py - Forest-based swarm architecture
• fund_manager_forest.py - Financial fund management forest
• medical_forest_swarm.py - Medical domain forest swarm
• tree_example.py - Basic tree structure example
• tree_swarm_test.py - Tree swarm testing

Graph Workflow

• advanced_graph_workflow.py - Advanced graph-based workflows
• graph_workflow_basic.py - Basic graph workflow
• graph_workflow_example.py - Complete graph workflow example
• graph_workflow_validation.py - Workflow validation
• test_enhanced_json_export.py - JSON export testing
• test_graph_workflow_caching.py - Caching tests
• test_graphviz_visualization.py - Visualization tests
• test_parallel_processing_example.py - Parallel processing tests
• graph/ - Core graph utilities
• example_images/ - Visualization images

Group Chat

• interactive_groupchat_example.py - Interactive group chat
• quantum_physics_swarm.py - Physics-focused group chat
• random_dynamic_speaker_example.py - Dynamic speaker selection
• groupchat_examples/ - Additional group chat patterns

Heavy Swarm

• heavy_swarm_example_one.py - First heavy swarm example
• heavy_swarm_example.py - Main heavy swarm implementation
• heavy_swarm_no_dashboard.py - Heavy swarm without dashboard
• medical_heavy_swarm_example.py - Medical heavy swarm

Hierarchical Swarm

• hierarchical_swarm_basic_demo.py - Basic hierarchical demo
• hierarchical_swarm_batch_demo.py - Batch processing demo
• hierarchical_swarm_comparison_demo.py - Comparison demo
• hierarchical_swarm_example.py - Main hierarchical example
• hierarchical_swarm_streaming_demo.py - Streaming demo
• hierarchical_swarm_streaming_example.py - Streaming example
• hs_interactive.py - Interactive hierarchical swarm
• hs_stock_team.py - Stock trading team
• hybrid_hiearchical_swarm.py - Hybrid approach
• sector_analysis_hiearchical_swarm.py - Sector analysis
• hiearchical_examples/ - Additional hierarchical examples
• hiearchical_swarm_ui/ - UI components
• hscf/ - Hierarchical framework examples

Interactive Group Chat

• interactive_groupchat_speaker_example.py - Speaker management
• medical_panel_example.py - Medical panel discussion
• speaker_function_examples.py - Speaker function examples
• stream_example.py - Streaming example

Majority Voting

• majority_voting_example_new.py - Updated voting example
• majority_voting_example.py - Basic voting example
• snake_game_code_voting.py - Game code voting

MAR (Multi-Agent Reinforcement)

• mar/ - Multi-agent reinforcement learning examples

MOA Examples

• moa_examples/ - Multi-objective agent examples

Spreadsheet Examples

• new_spreadsheet_new_examples/ - Latest spreadsheet integrations
• new_spreadsheet_swarm_examples/ - Spreadsheet swarm examples

Orchestration

• orchestration_examples/ - Workflow orchestration patterns

Paper Implementations

• paper_implementations/ - Academic paper implementations

Sequential Workflow

• sequential_workflow/ - Sequential processing examples

Simulations

• simulations/ - Various simulation scenarios

Swarm Router

• swarm_router/ - Routing and load balancing

Swarm Arrange

• swarmarrange/ - Agent arrangement utilities

Swarms API

• swarms_api_examples/ - API integration examples

Utils

• utils/ - Utility functions and helpers

Additional Files

• duo_agent.py - Two-agent collaboration
• enhanced_collaboration_example.py - Enhanced collaboration patterns