Cutting-edge framework for orchestrating role-playing, autonomous AI agents. By fostering collaborative intelligence, CrewAI empowers agents to work together seamlessly, tackling complex tasks.

Homepage | Documentation | Chat with Docs | Examples | Discord

Why CrewAI?
Getting Started
Key Features
Examples
Connecting Your Crew to any Model
How CrewAI Compares
Contribution
crewAI Enterprise
License

Why crewAI?

crewAI is designed to enable AI agentsoperate in a cohesive unit, by assuming roles, and sharing goals. Whether you're building a smart assistant platform, an automated customer service ensemble, or a multi-agent research team, crewAI provides the backbone for sophisticated multi-agent interactions that can be integrate into products and automations.

Getting Started

To get started with CrewAI, follow these simple steps:

1. Installation

pip install crewai

The example below also uses DuckDuckGo's Search. You can install it with pip too:

pip install duckduckgo-search

2. Setting Up Your Crew

Example for crew using the sequential process:

import os
from crewai import Agent, Task, Crew, Process

os.environ["OPENAI_API_KEY"] = "YOUR_API_KEY"

# You can choose to use any major provider and local models as well, check the docs: https://docs.crewai.com/how-to/LLM-Connections/

from langchain_community.tools import DuckDuckGoSearchRun
search_tool = DuckDuckGoSearchRun()

# Define your agents with roles and goals
researcher = Agent(
  role='Senior Research Analyst',
  goal='Uncover cutting-edge developments in AI ',
  backstory="""You work at a leading tech think tank.
  Your expertise lies in identifying emerging trends.
  You have a knack for dissecting complex data and presenting actionable insights.""",
  verbose=True,
  allow_delegation=False,
  tools=[search_tool]
)

writer = Agent(
  role='Tech Content Strategist',
  goal='Craft compelling content about tech',
  backstory="""You are a renowned Content Strategist, known for transforming complex concepts into compelling narratives.""",
  verbose=True,
  allow_delegation=True
)

# Create tasks for your agents
task1 = Task(
  description="""Conduct a comprehensive analysis of the latest advancements in AI in 2024.
  Identify key trends, breakthrough technologies, and potential industry impacts.""",
  expected_output="A comprehensive full analysis report.",
  agent=researcher
)

task2 = Task(
  description="""Using the insights provided, develop an engaging blog
  post that highlights the most significant AI advancements.
  Your post should be informative yet accessible, catering to a tech-savvy audience.
  Make it sound cool, avoid complex words so it doesn't sound like AI.""",
  expected_output="A complete 4 paragraph long blog post that is engaging and informative.",
  agent=writer
)

# Instantiate your crew with a sequential process
crew = Crew(
  agents=[researcher, writer],
  tasks=[task1, task2],
  Process=Process.sequential, # You can use different processes: https://docs.crewai.com/core-concepts/Managing-Processes/
  verbose=2, # You can set it to 1 or 2 to different logging levels
)

# Get your crew to work!
result = crew.kickoff()

print("######################")
print(result)

In addition to the sequential process, you can use the hierarchical process, which automatically assigns a manager to the defined crew to properly coordinate the planning and execution of tasks through delegation and validation of results. See more about the processes here.

Key Features

Role-Based Agent Design: Customize agents with specific roles, goals, and tools.
Autonomous Inter-Agent Delegation: Agents can autonomously delegate tasks and inquire amongst themselves, enhancing problem-solving efficiency.
Flexible Task Management: Define tasks with customizable tools and assign them to agents dynamically.
Processes Driven: Currently supports sequential and hierarchical task execution, but more complex processes like consensual and autonomous are being worked on.
Works with Open Source Models: Run your crew using Open AI or open source models refer to the Connect crewAI to LLMs page for details on configuring you agents' connections to models, even ones running locally!

Examples

You can test different real life examples of AI crews in the Examples repository.

Quick Tutorial

Trip Planner

Check out code for this example or watch a video below:

Stock Analysis

Check out code for this example or watch a video below:

Connecting Your Crew to a Model

crewAI supports using various LLMs through a variety of connection options. By default your agents will use the OpenAI API when querying the model. However, there are several other ways to allow your agents to connect to models. For example, you can configure your agents to use a local model via the Ollama tool.

Please refer to the Connect crewAI to LLMs page for details on configuring you agents' connections to models.

How CrewAI Compares

Autogen: While Autogen excels in creating conversational agents capable of working together, it lacks an inherent concept of process, that ability to assign specific tasks to agents and a lot of the safeguards that created more reliable outcome in crewAI. In Autogen, orchestrating agents' interactions requires additional programming, which can become complex and cumbersome as the scale of tasks grows.
ChatDev: ChatDev introduced the idea of processes into the realm of AI agents, but its implementation is quite rigid. Customizations in ChatDev are limited and not geared towards production environments, which can hinder scalability and flexibility in real-world applications.

CrewAI's Advantage: CrewAI is built with production in mind. It offers the flexibility of Autogen's conversational agents and the structured process approach of ChatDev, but without the rigidity. CrewAI's processes are designed to be dynamic and adaptable, fitting seamlessly into both development and production workflows.

Contribution

Installing Dependencies

poetry lock
poetry install

Virtual Env

poetry shell

Pre-commit hooks

pre-commit install

Running Tests

poetry run pytest

Running static type checks

poetry run pyright

Packaging

poetry build

Installing Locally

pip install dist/*.tar.gz

crewAI Enterprise

crewAI Inc, is a company developing crewAI and crewAI Enterprise, we for a limited time are offer consulting with selected customers, to get them early access to our enterprise solution. If you are interested on having access to it and hiring weekly hours with our team, feel free to email us at joao@crewai.io.

License

CrewAI is released under the MIT License.

README.md

crewAI