Skip to content

Getting Started

Get up and running with SWARM in minutes.

  • :material-download: Installation

    Install SWARM and its dependencies

  • :material-rocket-launch: Quick Start

    Run your first simulation in 5 minutes

  • :material-file-document: Your First Scenario

    Build a custom scenario from scratch

  • :material-refresh: Reproducibility Guide

    Run reproducible experiments with proper artifact management

  • :material-notebook: Quickstart Notebook

    Run two scenarios in Colab with plots — no local setup needed Open In Colab

Prerequisites

  • Python 3.10+
  • pip or uv package manager

Quick Install

pip install swarm-safety

Or for development:

git clone https://github.com/swarm-ai-safety/swarm.git
cd swarm
pip install -e ".[dev]"

Next Steps

After installation, follow the Quick Start guide to run your first multi-agent simulation and observe emergent risk dynamics.