crewAI

让多个 AI 角色组队协作,搞定复杂任务!

开源 🏷️基础免费,高级付费 ✅ 目前可打开 智能体 🍴 复刻 9118 🐛 待处理 1214 👀 关注 386
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 60685
维护状态 活跃
是否开源 开源
定价模式 🏷️基础免费,高级付费 支持限时试用 · 开源框架免费,提供托管平台CrewAI Studio,有免费额度,付费解锁更多功能。

项目预览

crewAI 项目界面预览图
图片来源:项目官网

项目数据

分类智能体
开发团队crewAIInc
官网地址https://crewai.com
定价模式🏷️基础免费,高级付费
价格说明开源框架免费,提供托管平台CrewAI Studio,有免费额度,付费解锁更多功能。
访问状态✅ 目前可打开
是否开源是
开源协议MIT
主要语言Python
技术栈/模型agents,ai,ai-agents,aiagentframework,llms
GitHub 星标★ 60685
上线时间2023-10-27 00:00:00
代码更新2026-11-09
仓库体积301.2 MB
本站数据更新2026-11-09
维护状态活跃
收录时间2026-08-09
浏览次数5

项目介绍

crewAI 是一个用于编排角色扮演、自主 AI 智能体的 Python 框架。它通过促进协作智能,让多个具有不同角色和目标的 AI 智能体协同工作,共同解决复杂任务。该框架解决了单个大语言模型在处理复杂工作流时能力受限的问题,提供了一种结构化的方式来定义智能体、分配任务、管理工具,并控制执行流程。其核心能力包括:基于角色的智能体定义、任务分解与分配、动态任务执行、内置工具集成、以及流程管理(如顺序执行和层级管理)。crewAI 的设计理念是模拟真实团队合作,让每个智能体扮演特定角色(如研究员、分析师、写手),通过协作完成从市场调研到内容生成等端到端任务。它提供了简洁的 API 和丰富的配置选项,使开发者能够快速构建复杂的多智能体应用,而无需深入底层的大模型交互细节。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 60685

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 8 步

环境要求

  • Python >=3.10 且 <3.14
  • 已安装 uv 包管理器
  • Windows 用户如遇编译错误需安装 Visual Studio Build Tools(Desktop development with C++)
  • 准备模型提供商的 API Key;若使用网页搜索还需 Serper.dev API Key

安装与启动步骤

  1. 1检查 Python 版本

    CrewAI 要求 Python >=3.10 且 <3.14,先确认本机版本是否满足。版本不符请先升级或切换 Python。

    python3 --version
  2. 2安装 uv(macOS/Linux)

    CrewAI 使用 uv 管理依赖与包,官方推荐脚本安装。系统无 curl 时可改用 wget 命令。

    curl -LsSf https://astral.sh/uv/install.sh | sh
  3. 3安装 uv(Windows)

    Windows 用户用 PowerShell 执行官方安装脚本。若失败可参考 UV 官方安装指南排查。

    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  4. 4安装 CrewAI CLI

    用 uv 安装全局 crewai 命令行工具。若提示 PATH 警告,再执行 uv tool update-shell 修复。

    uv tool install crewai
  5. 5验证安装

    列出已安装的 uv 工具,确认 crewai 已出现及版本号,例如 crewai v0.102.0。

    uv tool list
  6. 6创建项目

    用 crewai create crew 命令生成新项目脚手架,把 <project_name> 换成你自己的项目名。

    crewai create crew my_project
  7. 7配置 .env

    在项目 .env 中填写模型提供商 API Key;若使用网页搜索,再填 SERPER_API_KEY=YOUR_KEY_HERE。

  8. 8安装依赖并运行

    在项目目录下先 crewai install 安装依赖,再 crewai run 启动。需要额外包时用 uv add <package-name> 添加。

    crewai install
    crewai run

关键配置

配置项必填说明示例
模型提供商 API Key是调用大模型必需,具体变量名见官方 LLM setup 文档sk-xxxxxxxx
SERPER_API_KEY否使用网页搜索工具时必需,从 Serper.dev 获取YOUR_KEY_HERE

如何确认成功

uv tool list 能看到 crewai 及版本号;crewai run 后控制台有输出,且项目根目录生成 output/report.md。

常见问题

Q:如何安装 CrewAI?

A:先用 UV 安装 CLI:uv tool install crewai;再执行 crewai create crew <project_name> 创建项目,随后 crewai install 安装依赖、crewai run 启动。

Q:Windows 上安装报 chroma-hnswlib==0.7.6 编译错误怎么办?

A:错误提示 fatal error C1083: Cannot open include file: 'float.h' 时,请安装 Visual Studio Build Tools 并勾选“Desktop development with C++”。

Q:出现 PATH 警告怎么办?

A:执行 uv tool update-shell 刷新 shell 配置即可。

Q:如何升级 CrewAI?

A:升级全局 CLI 用 uv tool install crewai --upgrade;项目虚拟环境内的 crewai 版本需按官方升级指南单独处理。

Q:CrewAI 支持云端和本地部署吗?

A:CrewAI AMP 同时支持云端与本地(on-premise)部署,可满足企业的安全与合规要求。

注意事项

  • 运行前务必在 .env 中配置模型提供商 API Key,否则无法执行任务
  • Python 版本必须满足 >=3.10 且 <3.14
  • uv tool install crewai --upgrade 只升级全局 CLI,不影响项目内的 crewai 版本
  • 层级(hierarchical)流程会自动指派经理来协调任务规划与执行,可按需选择

核心亮点

  • 角色扮演式智能体设计,直观模拟团队协作,易于理解和使用
  • 支持动态任务分配和流程编排,可处理复杂工作流
  • 与 LangChain 工具生态兼容,扩展性强

不足之处

  • 智能体间通信和协调机制相对简单,复杂场景下可能效率不高
  • 文档/社区待观察

适用场景

  • 自动化市场调研与竞品分析报告生成
  • 多步骤内容创作(如博客、视频脚本)流水线
  • 企业内部流程自动化(如客户支持工单分类与回复)

替代项目

AutoGen、LangGraph、MetaGPT

上一篇:claude-code-best-practice

下一篇:goose

同类项目推荐

aura 开源

几分钟部署生产级 SRE 智能体,安全搞定基础设施运维

AURA is a production-tested SRE agent platform you can deploy in minutes. AURA hand···

★ 412 2026-08-09
lerim 开源

把 AI 代理的每次执行轨迹,变成可复用的上下文资产

Compiles AI agent traces and truns them into reusable context.

★ 99 2026-08-09
Ori-Mnemos 开源

让AI记住一切,本地优先的持久记忆框架

Local-first persistent agentic memory powered by Recursive Memory Harness (RMH). Ope···

★ 335 2026-08-09
portal 开源

手机浏览器上随时操控 AI 编程代理,内置终端和 Git 集成

Mobile first batteries included web ui for sst/opencode. Git integration, in browser···

★ 814 2026-08-09
pilotfish 开源

让便宜模型干活,贵模型把关,省钱又保质量

Multi-model orchestration layer for Claude Code — the frontier model plans, cheaper···

★ 716 2026-08-09
AgentOS 开源

像管公司一样管智能体,一个控制台搞定所有 AI 任务。

Run agents like a company. AgentOS is the native control plane for OpenClaw — manag···

★ 133 2026-08-09
free4chat 开源

开个临时房间,拉人拉AI传文件,用完即走

Temporary rooms for Humans and AI Agents — run, supervise and steer Agent Tasks wit···

★ 1229 2026-09-25
build-claude-code 开源

手把手带你从0写一个Claude Code,搞懂AI Agent内核

从0到1构建 Claude code (学习版)

★ 139 2026-08-09