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.

Install CrewAI 🚀

• Run the following command to install crewai CLI:

  uv tool install crewai

  Warning

  If you encounter a PATH warning, run this command to update your shell:

  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:

  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

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
  ├── .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:

  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:
  crewai install

• If you need to install additional packages, use:
  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:
  crewai run