<p align="center"> <a href="https://github.com/crewAIInc/crewAI"> <img src="docs/images/crewai_logo.png" width="600px" alt="Open source Multi-AI Agent orchestration framework"> </a> </p> <p align="center" style="display: flex; justify-content: center; gap: 20px; align-items: center;"> <a href="https://trendshift.io/repositories/11239" target="_blank"> <img src="https://trendshift.io/api/badge/repositories/11239" alt="crewAIInc%2FcrewAI | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/> </a> </p> <p align="center"> <a href="https://crewai.com">Homepage</a> · <a href="https://docs.crewai.com">Docs</a> · <a href="https://app.crewai.com">Start Cloud Trial</a> · <a href="https://blog.crewai.com">Blog</a> · <a href="https://community.crewai.com">Forum</a> </p> <p align="center"> <a href="https://github.com/crewAIInc/crewAI"> <img src="https://img.shields.io/github/stars/crewAIInc/crewAI" alt="GitHub Repo stars"> </a> <a href="https://github.com/crewAIInc/crewAI/network/members"> <img src="https://img.shields.io/github/forks/crewAIInc/crewAI" alt="GitHub forks"> </a> <a href="https://github.com/crewAIInc/crewAI/issues"> <img src="https://img.shields.io/github/issues/crewAIInc/crewAI" alt="GitHub issues"> </a> <a href="https://github.com/crewAIInc/crewAI/pulls"> <img src="https://img.shields.io/github/issues-pr/crewAIInc/crewAI" alt="GitHub pull requests"> </a> <a href="https://opensource.org/licenses/MIT"> <img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License: MIT"> </a> </p> <p align="center"> <a href="https://pypi.org/project/crewai/"> <img src="https://img.shields.io/pypi/v/crewai" alt="PyPI version"> </a> <a href="https://pypi.org/project/crewai/"> <img src="https://img.shields.io/pypi/dm/crewai" alt="PyPI downloads"> </a> <a href="https://twitter.com/crewAIInc"> <img src="https://img.shields.io/twitter/follow/crewAIInc?style=social" alt="Twitter Follow"> </a> </p>

Fast and Flexible Multi-Agent Automation Framework

CrewAI is a lean, lightning-fast Python framework built entirely from scratch—completely independent of LangChain or other agent frameworks. It empowers developers with both high-level simplicity and precise low-level control, ideal for creating autonomous AI agents tailored to any scenario.

• CrewAI Crews: Optimize for autonomy and collaborative intelligence.
• CrewAI Flows: The enterprise and production architecture for building and deploying multi-agent systems. Enable granular, event-driven control, single LLM calls for precise task orchestration and supports Crews natively

With over 100,000 developers certified through our community courses at learn.crewai.com, CrewAI is rapidly becoming the standard for enterprise-ready AI automation.

CrewAI AMP Suite

CrewAI AMP Suite is a comprehensive bundle tailored for organizations that require secure, scalable, and easy-to-manage agent-driven automation.

You can try one part of the suite the Crew Control Plane for free

Crew Control Plane Key Features:

• Tracing & Observability: Monitor and track your AI agents and workflows in real-time, including metrics, logs, and traces.
• Unified Control Plane: A centralized platform for managing, monitoring, and scaling your AI agents and workflows.
• Seamless Integrations: Easily connect with existing enterprise systems, data sources, and cloud infrastructure.
• Advanced Security: Built-in robust security and compliance measures ensuring safe deployment and management.
• Actionable Insights: Real-time analytics and reporting to optimize performance and decision-making.
• 24/7 Support: Dedicated enterprise support to ensure uninterrupted operation and quick resolution of issues.
• On-premise and Cloud Deployment Options: Deploy CrewAI AMP on-premise or in the cloud, depending on your security and compliance requirements.

CrewAI AMP is designed for enterprises seeking a powerful, reliable solution to transform complex business processes into efficient, intelligent automations.

Table of contents

• Why CrewAI?
• Getting Started
• Key Features
• Understanding Flows and Crews
• CrewAI vs LangGraph
• Examples
  • Quick Tutorial
  • Write Job Descriptions
  • Trip Planner
  • Stock Analysis
  • Using Crews and Flows Together
• Connecting Your Crew to a Model
• How CrewAI Compares
• Frequently Asked Questions (FAQ)
• Contribution
• Telemetry
• License

Why CrewAI?

<div align="center" style="margin-bottom: 30px;"> <img src="docs/images/asset.png" alt="CrewAI Logo" width="100%"> </div>

CrewAI unlocks the true potential of multi-agent automation, delivering the best-in-class combination of speed, flexibility, and control with either Crews of AI Agents or Flows of Events:

• Standalone Framework: Built from scratch, independent of LangChain or any other agent framework.
• High Performance: Optimized for speed and minimal resource usage, enabling faster execution.
• Flexible Low Level Customization: Complete freedom to customize at both high and low levels - from overall workflows and system architecture to granular agent behaviors, internal prompts, and execution logic.
• Ideal for Every Use Case: Proven effective for both simple tasks and highly complex, real-world, enterprise-grade scenarios.
• Robust Community: Backed by a rapidly growing community of over 100,000 certified developers offering comprehensive support and resources.

CrewAI empowers developers and enterprises to confidently build intelligent automations, bridging the gap between simplicity, flexibility, and performance.

Getting Started

Setup and run your first CrewAI agents by following this tutorial.

Learning Resources

Learn CrewAI through our comprehensive courses:

• Multi AI Agent Systems with CrewAI - Master the fundamentals of multi-agent systems
• Practical Multi AI Agents and Advanced Use Cases - Deep dive into advanced implementations

Understanding Flows and Crews

CrewAI offers two powerful, complementary approaches that work seamlessly together to build sophisticated AI applications:

1. Crews: Teams of AI agents with true autonomy and agency, working together to accomplish complex tasks through role-based collaboration. Crews enable:

   • Natural, autonomous decision-making between agents
   • Dynamic task delegation and collaboration
   • Specialized roles with defined goals and expertise
   • Flexible problem-solving approaches

2. Flows: Production-ready, event-driven workflows that deliver precise control over complex automations. Flows provide:

   • Fine-grained control over execution paths for real-world scenarios
   • Secure, consistent state management between tasks
   • Clean integration of AI agents with production Python code
   • Conditional branching for complex business logic

The true power of CrewAI emerges when combining Crews and Flows. This synergy allows you to:

• Build complex, production-grade applications
• Balance autonomy with precise control
• Handle sophisticated real-world scenarios
• Maintain clean, maintainable code structure

Getting Started with Installation

To get started with CrewAI, follow these simple steps:

1. Installation

Ensure you have Python >=3.10 <3.14 installed on your system. CrewAI uses UV for dependency management and package handling, offering a seamless setup and execution experience.

First, install CrewAI:

uv pip install crewai

If you want to install the 'crewai' package along with its optional features that include additional tools for agents, you can do so by using the following command:

uv pip install 'crewai[tools]'

The command above installs the basic package and also adds extra components which require more dependencies to function.

Troubleshooting Dependencies

If you encounter issues during installation or usage, here are some common solutions:

Common Issues

1. ModuleNotFoundError: No module named 'tiktoken'

   • Install tiktoken explicitly: uv pip install 'crewai[embeddings]'
   • If using embedchain or other tools: uv pip install 'crewai[tools]'

2. Failed building wheel for tiktoken

   • Ensure Rust compiler is installed (see installation steps above)
   • For Windows: Verify Visual C++ Build Tools are installed
   • Try upgrading pip: uv pip install --upgrade pip
   • If issues persist, use a pre-built wheel: uv pip install tiktoken --prefer-binary

2. Setting Up Your Crew with the YAML Configuration

To create a new CrewAI project, run the following CLI (Command Line Interface) command:

crewai create crew <project_name>

This command creates a new project folder with the following structure:

my_project/
├── .gitignore
├── 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

You can now s