Install Swarms
Get started with the Swarms framework in minutes. Choose your preferred installation method and start building multi-agent AI systems.
Recommended · uv
Quick start
The fastest way to get Swarms up and running — uv is up to 10x faster than pip.
01 — Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh02 — Install Swarms
uv pip install swarms03 — Verify installation
python -c 'import swarms; print(swarms.__version__)'Choose your method
Installation methods
Choose the installation method that works best for your environment.
Install with pip
Standard Python package installer — works on all platforms.
Basic installation
pip install swarmsWith specific version
pip install swarms==5.1.0Upgrade to latest
pip install --upgrade swarmsBefore you begin
Requirements & verification
System requirements
- Python 3.8 or higher
- pip (Python package installer)
- Git (for source installation)
- Virtual environment (recommended)
Verify installation
Check version:
python -c 'import swarms; print(swarms.__version__)'Run a simple test:
python -c 'from swarms import Agent; print("Swarms installed successfully!")'What's next
Next steps
Now that you have Swarms installed, here's what you can do next.
Support
Troubleshooting
Common issues and their solutions.
Permission Errors
If you encounter permission errors, try installing in user space:
pip install --user swarmsVirtual Environment Issues
Create a fresh virtual environment:
python -m venv swarms-env && source swarms-env/bin/activate && pip install swarmsDependency Conflicts
Use uv for better dependency resolution:
uv pip install swarms --resolution=highestStill having issues?
Get help from our community on Discord or report an issue on GitHub.