Installation

Coding agent setup

Set up CrewAI in your coding agent

Copy a ready-to-paste setup prompt for Claude Code, Codex, Cursor, or any coding agent. It installs the official CrewAI skills, checks the CLI, and points the agent at the right docs before it edits code.

View coding-agent guide

Watch: Building CrewAI Agents & Flows with Coding Agent Skills

Video Tutorial

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

Text Tutorial

Note

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

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.

Install uv
- On macOS/Linux:
  
  Use curl to download the script and execute it with sh:
  Terminal window
```
curl -LsSf https://astral.sh/uv/install.sh | sh
```
  If your system doesn’t have curl, you can use wget:
  Terminal window
```
wget -qO- https://astral.sh/uv/install.sh | sh
```
- On Windows:
  
  Use irm to download the script and iex to execute it:
  Terminal window
```
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.
Install CrewAI 🚀
- Run the following command to install crewai CLI:
  Terminal window
```
uv tool install crewai
```
  Warning
  If you encounter a PATH warning, run this command to update your shell:
  Terminal window
  uv tool update-shell
  Warning
  
  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:
  Terminal window
```
uv tool list
```
- You should see something like:
  Terminal window
```
crewai v0.102.0
- crewai
```
- If you need to update crewai, run:
  Terminal window
```
uv tool install crewai --upgrade
```
Note

This upgrades the global crewai CLI tool only. To upgrade the crewai version inside your project’s virtual environment, see Upgrading CrewAI in a project.

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

Creating a CrewAI Project

crewai create crew now creates a JSON-first crew project. Agents live in agents/*.jsonc, tasks and crew-level settings live in crew.jsonc, and crewai run loads that JSON definition directly.

Generate Project Scaffolding

Run the crewai CLI command:
Terminal window
```
crewai create crew <your_project_name>
```

This creates a new project with the following structure:

my_project/
├── .gitignore
├── .env
├── agents/
│   └── researcher.jsonc
├── crew.jsonc
├── knowledge/
├── pyproject.toml
├── README.md
├── skills/
└── tools/

If you need the older Python/YAML scaffold with crew.py, config/agents.yaml, and config/tasks.yaml, run:
Terminal window
```
crewai create crew <your_project_name> --classic
```

Customize Your Project

Your project will contain these essential files:

File	Purpose
`crew.jsonc`	Configure the crew, task order, process, and input defaults
`agents/*.jsonc`	Define each agent’s role, goal, backstory, LLM, tools, and behavior
`.env`	Store API keys and environment variables
`tools/`	Optional Python files for `custom:<name>` tools
`knowledge/`	Optional knowledge files for agents
`skills/`	Optional skill files applied to the crew

Start by editing crew.jsonc and the files in agents/ to define your crew’s behavior.
Use {placeholder} values in agent and task text, then set defaults in crew.jsonc under inputs. When you run crewai run, the CLI prompts for any missing values.
Keep sensitive information like API keys in .env.

Run your Crew
- Before you run your crew, make sure to run:
  Terminal window
```
crewai install
```
- If you need to install additional packages, use:
  Terminal window
```
uv add <package-name>
```
  Note
  
  As a supply-chain security measure, CrewAI’s internal packages use exclude-newer = "3 days" in their pyproject.toml files. This means transitive dependencies pulled in by CrewAI won’t resolve packages released less than 3 days ago. Your own direct dependencies are not affected by this policy. If you notice a transitive dependency is behind, you can pin the version you want explicitly in your project’s dependencies.
- To run your crew, execute the following command in the root of your project:
  Terminal window
```
crewai run
```

Enterprise Installation Options

Next Steps

Quickstart: Flow + agent

Follow the quickstart to scaffold a Flow, run a one-agent crew, and produce a report.

Join the Community

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