项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 60685
使用教程
环境要求
- Python >=3.10 且 <3.14
- 已安装 uv 包管理器
- Windows 用户如遇编译错误需安装 Visual Studio Build Tools(Desktop development with C++)
- 准备模型提供商的 API Key;若使用网页搜索还需 Serper.dev API Key
安装与启动步骤
-
1检查 Python 版本
CrewAI 要求 Python >=3.10 且 <3.14,先确认本机版本是否满足。版本不符请先升级或切换 Python。
python3 --version -
2安装 uv(macOS/Linux)
CrewAI 使用 uv 管理依赖与包,官方推荐脚本安装。系统无 curl 时可改用 wget 命令。
curl -LsSf https://astral.sh/uv/install.sh | sh -
3安装 uv(Windows)
Windows 用户用 PowerShell 执行官方安装脚本。若失败可参考 UV 官方安装指南排查。
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" -
4安装 CrewAI CLI
用 uv 安装全局 crewai 命令行工具。若提示 PATH 警告,再执行 uv tool update-shell 修复。
uv tool install crewai -
5验证安装
列出已安装的 uv 工具,确认 crewai 已出现及版本号,例如 crewai v0.102.0。
uv tool list -
6创建项目
用 crewai create crew 命令生成新项目脚手架,把 <project_name> 换成你自己的项目名。
crewai create crew my_project -
7配置 .env
在项目 .env 中填写模型提供商 API Key;若使用网页搜索,再填 SERPER_API_KEY=YOUR_KEY_HERE。
-
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
下一篇:goose
同类项目推荐
aura
开源
几分钟部署生产级 SRE 智能体,安全搞定基础设施运维
AURA is a production-tested SRE agent platform you can deploy in minutes. AURA hand···
lerim
开源
把 AI 代理的每次执行轨迹,变成可复用的上下文资产
Compiles AI agent traces and truns them into reusable context.
Ori-Mnemos
开源
让AI记住一切,本地优先的持久记忆框架
Local-first persistent agentic memory powered by Recursive Memory Harness (RMH). Ope···
portal
开源
手机浏览器上随时操控 AI 编程代理,内置终端和 Git 集成
Mobile first batteries included web ui for sst/opencode. Git integration, in browser···
pilotfish
开源
让便宜模型干活,贵模型把关,省钱又保质量
Multi-model orchestration layer for Claude Code — the frontier model plans, cheaper···
AgentOS
开源
像管公司一样管智能体,一个控制台搞定所有 AI 任务。
Run agents like a company. AgentOS is the native control plane for OpenClaw — manag···
free4chat
开源
开个临时房间,拉人拉AI传文件,用完即走
Temporary rooms for Humans and AI Agents — run, supervise and steer Agent Tasks wit···
VillagerAgent-Minecraft-multiage···
开源
让多个AI村民在Minecraft里组队干活,还能听你指挥
(VillagerAgent ACL 2024) A Graph based Minecraft multi agents framework
build-claude-code
开源
手把手带你从0写一个Claude Code,搞懂AI Agent内核
从0到1构建 Claude code (学习版)
