Installation

Installation Options

Swarms can be installed in multiple ways depending on your preferences and development environment. Choose the method that best fits your workflow.

pip

Standard Python package installation

uv

Fast Rust-based installer (Recommended)

poetry

Modern dependency management

From Source

Development and contribution

Prerequisites

Before installing Swarms, ensure you have:

Python 3.10 or higher installed on your system
pip package manager (usually comes with Python)
An active internet connection

You can check your Python version by running python --version or python3 --version in your terminal.

Installation Methods

# Install the latest version of Swarms
pip3 install -U swarms

# Install uv if you haven't already
pip install uv

# Install Swarms using uv
uv pip install swarms

# Add Swarms to your poetry project
poetry add swarms

# Clone the repository
git clone https://github.com/kyegomez/swarms.git

# Navigate to the directory
cd swarms

# Install dependencies
pip install -r requirements.txt

Why Use uv? (Recommended)

uv is a fast Python package installer and resolver, written in Rust. It offers significant performance improvements over traditional pip:

10-100x Faster

Dramatically faster installation times compared to pip

Better Dependency Resolution

More reliable dependency resolution and conflict detection

Drop-in Replacement

Works as a direct replacement for pip commands

Verify Installation

After installation, verify that Swarms is correctly installed:

import swarms

print(f"Swarms version: {swarms.__version__}")
print("Swarms is ready!")

You can also run this as a one-liner:

python -c "import swarms; print('Swarms is ready!')"

Installing Specific Versions

If you need a specific version of Swarms:

# Install a specific version
pip3 install swarms==1.0.0

# Install the latest pre-release
pip3 install --pre swarms

# Install a specific version
uv pip install swarms==1.0.0

# Add a specific version
poetry add swarms@1.0.0

Development Installation

If you’re planning to contribute to Swarms or need the latest development features:

Clone the repository

git clone https://github.com/kyegomez/swarms.git
cd swarms

Install in editable mode

# Using pip
pip install -e .

# Or using uv
uv pip install -e .

Install development dependencies

pip install -r requirements.txt

Verify the installation

python -c "import swarms; print('Development installation successful!')"

Installing in editable mode (-e flag) allows you to modify the source code and see changes immediately without reinstalling.

Optional Dependencies

Swarms has optional dependencies for specific features:

# Install with all optional dependencies
pip3 install swarms[all]

# Install with specific extras
pip3 install swarms[tools]      # Additional tool integrations
pip3 install swarms[ui]         # Web UI components
pip3 install swarms[dev]        # Development tools

Virtual Environments (Recommended)

It’s recommended to install Swarms in a virtual environment to avoid conflicts with other packages:

venv
conda
poetry

# Create a virtual environment
python -m venv swarms-env

# Activate the environment
# On Linux/Mac:
source swarms-env/bin/activate
# On Windows:
swarms-env\Scripts\activate

# Install Swarms
pip install swarms

# Create a conda environment
conda create -n swarms-env python=3.10

# Activate the environment
conda activate swarms-env

# Install Swarms
pip install swarms

# Initialize a new project
poetry init

# Add Swarms
poetry add swarms

# Activate the virtual environment
poetry shell

Platform-Specific Notes

macOS

On macOS, you might need to install command-line tools:

xcode-select --install

If you’re using Apple Silicon (M1/M2), ensure you’re using a compatible Python version.

Windows

On Windows, you might need to install Microsoft C++ Build Tools:

Download from Microsoft C++ Build Tools
Install “Desktop development with C++” workload

Also, use python instead of python3 in commands.

Linux

On Linux, you might need to install additional system dependencies:

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install python3-dev build-essential

# Fedora/RHEL
sudo dnf install python3-devel gcc

Upgrading Swarms

To upgrade to the latest version:

pip3 install -U swarms

uv pip install --upgrade swarms

poetry update swarms

Uninstalling Swarms

If you need to uninstall Swarms:

pip3 uninstall swarms

uv pip uninstall swarms

poetry remove swarms

Troubleshooting

Permission denied errors

If you encounter permission errors, try:

# Add --user flag (not recommended with virtual environments)
pip3 install --user swarms

# Or use sudo (not recommended)
sudo pip3 install swarms

Better solution: Use a virtual environment to avoid permission issues.

SSL certificate errors

If you encounter SSL errors:

pip3 install --trusted-host pypi.org --trusted-host files.pythonhosted.org swarms

Package conflicts

If you have dependency conflicts:

Create a fresh virtual environment
Install Swarms first before other packages
Use uv for better dependency resolution

ImportError after installation

If you can install but can’t import:

Check you’re using the correct Python interpreter
Verify the virtual environment is activated
Try reinstalling: pip uninstall swarms && pip install swarms

Next Steps

Now that you’ve installed Swarms, proceed to:

Environment Setup

Configure your API keys and workspace

Quickstart Guide

Create your first agent in minutes

Need help with installation? Join our Discord community for support!

Getting Started

Core Concepts

Agent Development

Reasoning Agents

Multi-Agent Architectures

Deployment & Operations

Integrations

CLI Reference

Changelog

Installation Options

pip

uv

poetry

From Source

Prerequisites

Installation Methods

Why Use uv? (Recommended)

10-100x Faster

Better Dependency Resolution

Drop-in Replacement

Verify Installation

Installing Specific Versions

Development Installation

Optional Dependencies

Virtual Environments (Recommended)

Platform-Specific Notes

Upgrading Swarms

Uninstalling Swarms

Troubleshooting

Next Steps

Environment Setup

Quickstart Guide

​Installation Options

pip

uv

poetry

From Source

​Prerequisites

​Installation Methods

​Why Use uv? (Recommended)

10-100x Faster

Better Dependency Resolution

Drop-in Replacement

​Verify Installation

​Installing Specific Versions

​Development Installation

​Optional Dependencies

​Virtual Environments (Recommended)

​Platform-Specific Notes

​Upgrading Swarms

​Uninstalling Swarms

​Troubleshooting

​Next Steps

Environment Setup

Quickstart Guide

Installation Options

Prerequisites

Installation Methods

Why Use uv? (Recommended)

Verify Installation

Installing Specific Versions

Development Installation

Optional Dependencies

Virtual Environments (Recommended)

Platform-Specific Notes

Upgrading Swarms

Uninstalling Swarms

Troubleshooting

Next Steps