本文是第一次使用crewai，主要记录安装、创建、运行，具体怎么搭建自己的agent暂时不包含。
github链接：https://github.com/crewAIInc/crewAI
crewai网址：https://docs.crewai.com/introduction

1、环境准备

1.1 python

python3.10-3.13之间。在终端中使用命令查看python版本。本文使用3.10。

python --version

1.2 使用pip下载crewai

我是看github上面的crewai项目视频来的。

视频中是使用的uv安装crewai，但是我看到readme文件中也有pip install crewai，本文使用pip进行下载。原因：使用uv下载，路径问题没有解决，后面会说明。

pip install crewai -i https://mirrors.aliyun.com/pypi/simple/

这个过程需要等一会，下载完成进行检验。

1.3 使用uv下载crewai（有问题未解决）

先下载uv：

pip install uv -i https://mirrors.aliyun.com/pypi/simple/

之后安装crewai：

uv tool install crewai

这个过程需要等待一会。

第一次下载会出现警告信息，路径的问题：

可以运行uv tool update-shell：

可以查看所有已安装的工具：

uv tool list

可以看到已安装的crewai版本，确认成功安装。

可以更新crewai到最新版本（可选）：

uv tool install crewai--upgrade

使用命令创建crewai项目：

crewai create crew <project_name>

有报错：

将C:\Users\25511.local\bin手动加入到环境变量中也找不到crewai，不是很清楚。目前是uv --version能输出uv的版本，但是crewai --version说找不到crewai，但是uv tool list能输出crewai。

2、创建crewai项目

使用命令创建crewai项目：

crewai create crew <project_name>

选择要用的产品，输入对应的数字编号就行，使用openai就输入1。

不选就输入q，本文使用gemini。

注意：经过尝试，如果前面不选，按q退出，那么创造出来的crew项目里是空的，只有前面都选了，api什么的可以不填，这样创建的crew项目里会有默认的文件和示例。

进入到创建的crew项目中。

没选代理产品的结果：

选了代理产品的结果：

• knowledge：知识库，可以添加pdf或者别的知识。
• src：包含config和tools，config中是agents，tasks的yaml文件，tools中是crew.py和main.py。

目录结构：

见readme文件介绍：

3、运行crew项目

安装项目所需的包：

crewai install

在.env文件中将apikey填写完整，运行：

crewai run

这里只截取首尾的图片。

注意：要在.env文件中把apikey补充完整再运行，不然会报错。

如果是想先跑通的话，可以去获取一个gemini的免费api。

https://aistudio.google.com/apikey

完毕。