Skip to main content

​
Video Tutorial

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

​
Text Tutorial

Python Version RequirementsCrewAI 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 RequirementCrewAI 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:
    FilePurpose
    agents.yamlDefine your AI agents and their roles
    tasks.yamlSet up agent tasks and workflows
    .envStore API keys and environment variables
    main.pyProject entry point and execution flow
    crew.pyCrew 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.
⌘I