​
视频教程

观看此视频教程，获取安装过程的分步演示

​
文本教程

Python 版本要求

CrewAI 要求 Python >=3.10 and <3.13。以下是检查版本的方法

python3 --version

如果你需要更新 Python，请访问 python.org/downloads

CrewAI 使用 uv 作为其依赖管理和包处理工具。它简化了项目设置和执行，提供了流畅的体验。

如果你还没有安装 uv，请按照步骤 1 快速在你的系统上设置它；否则，你可以跳到步骤 2。

1

安装 uv

  • 在 macOS/Linux 上

    使用 curl 下载脚本并使用 sh 执行它

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

    如果你的系统没有 curl，可以使用 wget

    wget -qO- https://astral.sh/uv/install.sh | sh

  • 在 Windows 上

    使用 irm 下载脚本并使用 iex 执行它

    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

    如果你遇到任何问题，请参阅 UV 的安装指南以获取更多信息。

2

安装 CrewAI 🚀

  • 运行以下命令安装 crewai CLI

    uv tool install crewai

    如果你遇到 PATH 警告，运行此命令更新你的 shell

    uv tool update-shell

    如果在 Windows 上遇到 chroma-hnswlib==0.7.6 构建错误（fatal error C1083: Cannot open include file: 'float.h'），请安装带 Desktop development with C++ 的 (Visual Studio Build Tools)[https://visualstudio.microsoft.com/downloads/]。

  • 要验证 crewai 是否已安装，运行

    uv tool list

  • 你应该会看到类似

    crewai v0.102.0
- crewai

  • 如果你需要更新 crewai，运行

    uv tool install crewai --upgrade
安装成功！你已准备好创建你的第一个工作组！🎉

​
创建 CrewAI 项目

我们建议使用 YAML 模板脚手架来以结构化的方法定义智能体和任务。以下是入门方法

1

生成项目脚手架

  • 运行 crewai CLI 命令

    crewai create crew <your_project_name>

  • 这将创建一个具有以下结构的新项目

    my_project/
├── .gitignore
├── knowledge/
├── pyproject.toml
├── README.md
├── .env
└── src/
    └── my_project/
        ├── __init__.py
        ├── main.py
        ├── crew.py
        ├── tools/
        │   ├── custom_tool.py
        │   └── __init__.py
        └── config/
            ├── agents.yaml
            └── tasks.yaml
2

定制你的项目

  • 你的项目将包含这些关键文件

    文件用途
    agents.yaml定义你的 AI 智能体及其角色
    tasks.yaml设置智能体任务和工作流
    .env存储 API 密钥和环境变量
    main.py项目入口点和执行流程
    crew.py工作组编排和协调
    tools/自定义智能体工具目录
    knowledge/知识库目录

  • 首先编辑 agents.yaml 和 tasks.yaml 来定义你的工作组的行为。

  • 将 API 密钥等敏感信息保存在 .env 中。

3

运行你的工作组

  • 在运行你的工作组之前，请确保运行 
    crewai install
  • 如果你需要安装额外的包，请使用 
    uv add <package-name>
  • 要在项目根目录运行你的工作组，执行以下命令 
    crewai run

​
企业版安装选项

对于团队和组织，CrewAI 提供企业级部署选项，消除了设置的复杂性

​
CrewAI 企业版 (SaaS)

  • 无需安装 - 只需在 app.crewai.com 免费注册
  • 自动更新和维护
  • 托管基础设施和扩展
  • 无需代码构建工作组

​
CrewAI Factory (私有化部署)

  • 为你的基础设施提供容器化部署
  • 支持任何超大规模提供商，包括本地部署
  • 与你现有安全系统的集成

探索企业版选项

了解 CrewAI 的企业版产品并安排演示

​
后续步骤

构建你的第一个智能体

遵循我们的快速入门指南，创建你的第一个 CrewAI 智能体并获得实践经验。

加入社区

与其他开发者联系，获取帮助，并分享你的 CrewAI 经验。