CrewAI项目安装与配置完全指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01132/article/details/148328182

CrewAI项目安装与配置完全指南

crewAI CrewAI 是一个前沿框架，用于协调具有角色扮演能力的自主 AI 代理，通过促进协作智能，使代理能够无缝协作，共同解决复杂任务。项目地址: https://gitcode.com/gh_mirrors/cr/crewAI

前言

CrewAI是一个创新的AI代理协作框架，它允许开发者创建能够协同工作的AI代理团队。本文将详细介绍如何在本地环境中安装和配置CrewAI，帮助开发者快速上手这一强大工具。

系统要求

在开始安装前，请确保您的系统满足以下基本要求：

Python版本：3.10至3.12（不包含3.13）
操作系统：支持Windows、macOS和Linux
硬件：建议至少8GB内存，现代多核CPU

您可以通过以下命令检查当前Python版本：

python3 --version

安装步骤详解

1. 安装uv工具

CrewAI使用uv作为其依赖管理和包处理工具，这是一个现代化的Python包管理工具，相比传统pip具有更快的安装速度和更好的依赖解析能力。

macOS/Linux系统安装

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

如果系统没有curl，可以使用wget替代：

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

Windows系统安装

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

安装完成后，如果遇到PATH警告，运行以下命令更新shell配置：

uv tool update-shell

2. 安装CrewAI核心包

安装CrewAI命令行工具：

uv tool install crewai

常见问题解决：

Windows用户如果遇到chroma-hnswlib构建错误，需要安装Visual Studio Build Tools并选择"Desktop development with C++"组件
安装完成后，验证安装是否成功：

uv tool list

应该能看到类似输出：

crewai v0.102.0
- crewai

如需更新CrewAI版本：

uv tool install crewai --upgrade

创建第一个CrewAI项目

项目初始化

使用以下命令创建新项目：

crewai create crew my_first_crew

这将生成标准项目结构：

my_first_crew/
├── .gitignore
├── knowledge/         # 知识库目录
├── pyproject.toml     # 项目配置文件
├── README.md
├── .env               # 环境变量文件
└── src/
    └── my_first_crew/
        ├── __init__.py
        ├── main.py     # 项目主入口
        ├── crew.py     # Crew协调逻辑
        ├── tools/      # 自定义工具目录
        │   ├── custom_tool.py
        │   └── __init__.py
        └── config/
            ├── agents.yaml  # 代理定义文件
            └── tasks.yaml   # 任务定义文件