> ## Documentation Index
> Fetch the complete documentation index at: https://docs.swarms.world/llms.txt
> Use this file to discover all available pages before exploring further.

# Multi-Agent Architectures Overview

> A comprehensive overview of all available multi-agent architectures in Swarms, their use cases, and functionality

## Overview

Swarms provides a wide range of multi-agent architectures designed for different use cases, from simple round-robin task distribution to complex hierarchical orchestration. This page provides a comprehensive overview to help you select the right architecture for your needs.

## Installation

```bash theme={null}
pip install -U swarms
```

## Core Architectures

| Architecture                                | Use Case                          | Key Functionality                                                   |
| ------------------------------------------- | --------------------------------- | ------------------------------------------------------------------- |
| [MajorityVoting](/api/majority-voting)      | Decision making through consensus | Combines multiple agent opinions and selects the most common answer |
| [AgentRearrange](/api/agent-rearrange)      | Optimizing agent order            | Dynamically reorders agents based on task requirements              |
| [RoundRobin](/api/round-robin-swarm)        | Equal task distribution           | Cycles through agents in a fixed order                              |
| [Mixture of Agents](/api/mixture-of-agents) | Complex problem solving           | Combines diverse expert agents for comprehensive analysis           |
| [GroupChat](/api/group-chat)                | Collaborative discussions         | Simulates group discussions with multiple agents                    |
| [SpreadSheetSwarm](/api/spreadsheet-swarm)  | Data processing                   | Collaborative data processing and analysis                          |
| [SwarmRouter](/api/swarm-router)            | Task routing                      | Routes tasks to appropriate agents based on requirements            |
| [MultiAgentRouter](/api/multi-agent-router) | Advanced task routing             | Routes tasks to specialized agents based on capabilities            |

## Workflow Architectures

| Architecture                                      | Use Case                              | Key Functionality                                                 |
| ------------------------------------------------- | ------------------------------------- | ----------------------------------------------------------------- |
| [ConcurrentWorkflow](/api/concurrent-workflow)    | Parallel task execution               | Executes multiple tasks simultaneously                            |
| [SequentialWorkflow](/api/sequential-workflow)    | Step-by-step processing               | Executes tasks in a specific sequence                             |
| [GraphWorkflow](/api/graph-workflow)              | Complex task dependencies             | Manages tasks with complex dependencies                           |
| [BatchedGridWorkflow](/api/batched-grid-workflow) | Grid-style parallel task distribution | Pairs each agent with a different task and runs them concurrently |

## Hierarchical Architectures

| Architecture                                    | Use Case                        | Key Functionality                                                        |
| ----------------------------------------------- | ------------------------------- | ------------------------------------------------------------------------ |
| [HierarchicalSwarm](/api/hierarchical-swarm)    | Hierarchical task orchestration | Director agent coordinates specialized worker agents                     |
| [Hybrid Hierarchical-Cluster Swarm](/api/hhcs)  | Complex organization            | Combines hierarchical and cluster-based organization                     |
| [Auto Swarm Builder](/api/auto-swarm-builder)   | Automated swarm creation        | Automatically creates and configures swarms                              |
| [PlannerWorkerSwarm](/api/planner-worker-swarm) | Plan-then-delegate execution    | A planner agent generates a step-by-step plan that worker agents execute |

## Reasoning and Decision Architectures

| Architecture                              | Use Case                              | Key Functionality                                                      |
| ----------------------------------------- | ------------------------------------- | ---------------------------------------------------------------------- |
| [HeavySwarm](/api/heavy-swarm)            | Deep, research-grade analysis         | Runs agents through many reasoning loops for intensive analysis        |
| [CouncilAsAJudge](/api/council-as-judge)  | High-stakes rulings with deliberation | A council of agents deliberates, then a judge agent delivers a verdict |
| [DebateWithJudge](/api/debate-with-judge) | Structured adversarial debate         | Agents argue opposing positions over multiple rounds; a judge rules    |
| [LLMCouncil](/api/llm-council)            | Consensus-based decision making       | An LLM-based council deliberates to reach a decision                   |

## Communication Structure

<Note>
  The [Conversation](/api/conversation) documentation details the communication protocols and structures used between agents in these architectures.
</Note>

## Choosing the Right Architecture

<Tip>
  **Task Complexity** -- Simple tasks may only need basic architectures like RoundRobin, while complex tasks might require Hierarchical or Graph-based approaches.
</Tip>

<Tip>
  **Parallelization Needs** -- If tasks can be executed in parallel, consider ConcurrentWorkflow or SpreadSheetSwarm.
</Tip>

<Tip>
  **Decision Making Requirements** -- For consensus-based decisions, MajorityVoting is ideal.
</Tip>

<Tip>
  **Resource Optimization** -- If you need to optimize agent usage, consider SwarmRouter or MultiAgentRouter.
</Tip>

<Tip>
  **Dynamic Adaptation** -- For tasks requiring dynamic adaptation, consider Auto Swarm Builder.
</Tip>

## Architecture Selection Guide

### By Task Type

| Task Type                   | Recommended Architecture             |
| --------------------------- | ------------------------------------ |
| Simple, sequential tasks    | SequentialWorkflow, RoundRobin       |
| Parallel, independent tasks | ConcurrentWorkflow, SpreadSheetSwarm |
| Consensus-based decisions   | MajorityVoting                       |
| Complex multi-domain tasks  | HierarchicalSwarm, HHCS              |
| Dynamic, evolving tasks     | Auto Swarm Builder                   |
| Collaborative analysis      | GroupChat, Mixture of Agents         |
| Task routing                | SwarmRouter, MultiAgentRouter        |

### By Scale

| Scale            | Recommended Architecture                       |
| ---------------- | ---------------------------------------------- |
| 2-5 agents       | RoundRobin, SequentialWorkflow, AgentRearrange |
| 5-20 agents      | SwarmRouter, GroupChat, ConcurrentWorkflow     |
| 20+ agents       | HierarchicalSwarm, HHCS, SpreadSheetSwarm      |
| Variable/dynamic | Auto Swarm Builder                             |

For more detailed information about each architecture, refer to their respective documentation pages linked in the tables above.