1. 环境准备:Python与依赖管理工具
在开始CrewAI智能体开发之前,确保你的开发环境满足基本要求是成功的第一步。作为一个长期从事AI开发的工程师,我见过太多因为环境配置不当导致后期开发受阻的案例。下面我会详细说明每个环节的注意事项。
1.1 Python版本检查与安装
CrewAI对Python版本有明确要求:必须使用Python 3.10到3.13之间的版本。这个范围的选择并非偶然——3.10引入了重要的模式匹配语法,而3.14尚未发布且可能存在兼容性问题。
检查当前Python版本的方法很简单,但有几个细节需要注意:
bash复制python3 --version
# 或者更详细的版本信息
python3 -c "import sys; print(sys.version)"
重要提示:如果你同时安装了Python 2和Python 3,确保使用python3命令而不是python,后者在某些系统上可能仍然指向Python 2.7。
如果版本不符合要求,建议通过pyenv进行多版本管理,这是我个人最推荐的方式:
bash复制# 安装pyenv
curl https://pyenv.run | bash
# 安装指定Python版本
pyenv install 3.11.6
# 设置全局Python版本
pyenv global 3.11.6
1.2 依赖管理工具uv
CrewAI使用uv作为默认的依赖管理工具,这确实是个明智的选择。uv由Astral开发(也是Rust著名格式化工具Rustfmt的开发者),相比传统pip有显著优势:
- 安装速度提升10-100倍
- 更精确的依赖解析
- 更好的缓存机制
- 兼容现有的pip和pip-tools工作流
安装uv的过程在不同平台上略有差异:
macOS/Linux:
bash复制curl -LsSf https://astral.sh/uv/install.sh | sh
Windows(PowerShell):
powershell复制irm https://astral.sh/uv/install.ps1 | iex
安装完成后,建议将~/.cargo/bin添加到PATH环境变量
