
📦 Prerequisites
Before installing CrewAI, ensure you have:
-
Python ≥ 3.8 installed (check with
python --version). -
pip (Python’s package manager) is available in your PATH.
-
(Optional) A virtual environment to isolate your dependencies:
python -m venv venv source venv/bin/activate # macOS/Linux venv\Scripts\activate # Windows
🚀 Installing CrewAI via pip
Run the following command in your terminal to install the core framework:
pip install crewai
This pulls the latest CrewAI release and its minimal dependencies.
🛠️ Adding Optional Tooling
CrewAI comes with built‑in Browser and Code Interpreter tools. To install these extras, append the [tools] extras tag:
pip install 'crewai[tools]'
You’ll now have access to:
-
BrowserAgentTool for automating web interactions
-
CodeInterpreterTool for executing and evaluating code snippets
✅ Verifying Your Installation
Confirm everything is working with a quick import check and version print:
python - << 'EOF' import crewai print("CrewAI version:", crewai.__version__) EOF
If you see the version number (e.g., 1.2.0), you’re all set!
🔍 Common Troubleshooting Tips
-
ModuleNotFoundErroron import: Make sure you’re in the same Python environment where you ranpip install. -
Permission errors (macOS/Linux): Use
pip install --user crewaior run within a virtual environment. -
Outdated pip: Upgrade pip to the latest version:
pip install --upgrade pip -
Firewall/Proxy issues: Configure
HTTP_PROXY/HTTPS_PROXYenvironment variables if you’re behind a corporate proxy.
With CrewAI installed, you’re ready to start defining your first Crews and Flows. Happy coding! 😎

Join the conversation! Your thoughts help the community grow.