How do I Install CrewAI?

📦 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

• ModuleNotFoundError on import: Make sure you’re in the same Python environment where you ran pip install.

• Permission errors (macOS/Linux): Use pip install --user crewai or run within a virtual environment.

• Outdated pip: Upgrade pip to the latest version:

  pip install --upgrade pip

• Firewall/Proxy issues: Configure HTTP_PROXY / HTTPS_PROXY environment variables if you’re behind a corporate proxy.

With CrewAI installed, you’re ready to start defining your first Crews and Flows. Happy coding! 😎