安装指南

安装 Swarms

几分钟内即可上手 Swarms 框架。选择你偏好的安装方式，开始构建多智能体 AI 系统。

快速开始

让 Swarms 快速运行起来的最佳方式 —— uv 的速度比 pip 快高达 10 倍。

01 — 安装 uv（如果尚未安装）

install.sh

curl -LsSf https://astral.sh/uv/install.sh | sh

02 — 安装 Swarms

shell

uv pip install swarms

03 — 验证安装

shell

python -c 'import swarms; print(swarms.__version__)'

选择安装方式

安装方式

选择最适合你运行环境的安装方式。

使用 pip 安装

标准 Python 包管理器 —— 适用于所有平台。

基础安装

terminal

pip install swarms

安装指定版本

terminal

pip install swarms==5.1.0

升级到最新版本

terminal

pip install --upgrade swarms

开始之前

环境要求与验证

系统要求

Python 3.8 或更高版本
pip（Python 包管理器）
Git（用于源码安装）
虚拟环境（推荐）

验证安装

检查版本：

terminal

python -c 'import swarms; print(swarms.__version__)'

运行简单测试：

terminal

python -c 'from swarms import Agent; print("Swarms installed successfully!")'

接下来

后续步骤

安装好 Swarms 之后，你可以尝试以下操作。

快速入门指南

几分钟内学习基础知识，创建你的第一个智能体。

查看指南

示例

探索实用示例与应用场景。

浏览示例

API 参考

全面的 API 文档与参考资料。

阅读文档

支持

故障排除

常见问题及解决方案。

权限错误

如果遇到权限错误，请尝试在用户空间中安装：

terminal

pip install --user swarms

虚拟环境问题

创建一个全新的虚拟环境：

terminal

python -m venv swarms-env && source swarms-env/bin/activate && pip install swarms

依赖冲突

使用 uv 获得更好的依赖解析：

terminal

uv pip install swarms --resolution=highest

仍然遇到问题？

在 Discord 社区寻求帮助，或在 GitHub 上提交问题。

加入 Discord 提交问题