Installation

Get started with CrewAI - Install, configure, and build your first AI crew

Video Tutorial

Watch this video tutorial for a step-by-step demonstration of the installation process:

Text Tutorial

Python Version Requirements

CrewAI requires Python >=3.10 and <3.14. Here’s how to check your version:

python3 --version

If you need to update Python, visit python.org/downloads

OpenAI SDK Requirement

CrewAI 0.175.0 requires openai >= 1.13.3. If you manage dependencies yourself, ensure your environment satisfies this constraint to avoid import/runtime issues.

CrewAI uses the uv as its dependency management and package handling tool. It simplifies project setup and execution, offering a seamless experience.

If you haven’t installed uv yet, follow step 1 to quickly get it set up on your system, else you can skip to step 2.

1. Install uv

   • On macOS/Linux:

     Use curl to download the script and execute it with sh:

     curl -LsSf https://astral.sh/uv/install.sh | sh
     

     If your system doesn’t have curl, you can use wget:

     wget -qO- https://astral.sh/uv/install.sh | sh
     

   • On Windows:

     Use irm to download the script and iex to execute it:

     powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
     

     If you run into any issues, refer to UV’s installation guide for more information.

2. Install CrewAI 🚀

   • Run the following command to install crewai CLI:

     uv tool install crewai
     
     If you encounter a PATH warning, run this command to update your shell:

     uv tool update-shell
     
     If you encounter the chroma-hnswlib==0.7.6 build error (fatal error C1083: Cannot open include file: 'float.h') on Windows, install Visual Studio Build Tools with Desktop development with C++.

   • To verify that crewai is installed, run:

     uv tool list
     

   • You should see something like:

     crewai v0.102.0
     - crewai
     

   • If you need to update crewai, run:

     uv tool install crewai --upgrade
     

   Installation successful! You’re ready to create your first crew! 🎉

Creating a CrewAI Project

We recommend using the YAML template scaffolding for a structured approach to defining agents and tasks. Here’s how to get started:

1. Generate Project Scaffolding

   • Run the crewai CLI command:

     crewai create crew <your_project_name>
     

   • This creates a new project with the following structure:

     my_project/
     ├── .gitignore
     ├── knowledge/
     ├── pyproject.toml
     ├── README.md
     ├── .env
     └── src/
         └── my_project/
             ├── __init__.py
             ├── main.py
             ├── crew.py
             ├── tools/
             │   ├── custom_tool.py
             │   └── __init__.py
             └── config/
                 ├── agents.yaml
                 └── tasks.yaml
     
2. Customize Your Project

   • Your project will contain these essential files:

     File	Purpose
     agents.yaml	Define your AI agents and their roles
     tasks.yaml	Set up agent tasks and workflows
     .env	Store API keys and environment variables
     main.py	Project entry point and execution flow
     crew.py	Crew orchestration and coordination
     tools/	Directory for custom agent tools
     knowledge/	Directory for knowledge base

   • Start by editing agents.yaml and tasks.yaml to define your crew’s behavior.

   • Keep sensitive information like API keys in .env.

3. Run your Crew

   • Before you run your crew, make sure to run:
     crewai install
     
   • If you need to install additional packages, use:
     uv add <package-name>
     
   • To run your crew, execute the following command in the root of your project:
     crewai run
     

Enterprise Installation Options

For teams and organizations, CrewAI offers enterprise deployment options that eliminate setup complexity:

CrewAI AMP (SaaS)

• Zero installation required - just sign up for free at app.crewai.com
• Automatic updates and maintenance
• Managed infrastructure and scaling
• Build Crews with no Code

CrewAI Factory (Self-hosted)

• Containerized deployment for your infrastructure
• Supports any hyperscaler including on prem deployments
• Integration with your existing security systems

Explore Enterprise Options

Learn about CrewAI’s enterprise offerings and schedule a demo

Next Steps

Build Your First Agent

Follow our quickstart guide to create your first CrewAI agent and get hands-on experience.

Join the Community

Connect with other developers, get help, and share your CrewAI experiences.