crewai
Cutting-edge framework for orchestrating role-playing, autonomous AI agents. By fostering collaborative intelligence, CrewAI empowers agents to work together seamlessly, tackling complex tasks.
Description
<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**: 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](https://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](https://app.crewai.com) ## 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?](#why-crewai) - [Getting Started](#getting-started) - [Key Features](#key-features) - [Understanding Flows and Crews](#understanding-flows-and-crews) - [CrewAI vs LangGraph](#how-crewai-compares) - [Examples](#examples) - [Quick Tutorial](#quick-tutorial) - [Write Job Descriptions](#write-job-descriptions) - [Trip Planner](#trip-planner) - [Stock Analysis](#stock-analysis) - [Using Crews and Flows Together](#using-crews-and-flows-together) - [Connecting Your Crew to a Model](#connecting-your-crew-to-a-model) - [How CrewAI Compares](#how-crewai-compares) - [Frequently Asked Questions (FAQ)](#frequently-asked-questions-faq) - [Contribution](#contribution) - [Telemetry](#telemetry) - [License](#license) ## Why CrewAI? <div align="center" style="margin-bottom: 30px;"> <img src="docs/images/asset.png" alt="CrewAI Logo" width="10
Release History
| Version | Changes | Urgency | Date |
|---|---|---|---|
| 1.14.2 | Imported from PyPI (1.14.2) | Low | 4/21/2026 |
| 1.14.3a2 | ## What's Changed ### Features - Add support for bedrock V4 - Add Daytona sandbox tools for enhanced functionality - Add 'Build with AI' page — AI-native docs for coding agents - Add Build with AI to Get Started navigation and page files for all languages (en, ko, pt-BR, ar) ### Bug Fixes - Fix propagation of implicit @CrewBase names to crew events - Resolve issue with duplicate batch initialization in execution metadata merge - Fix serialization of Task class-reference fields for checkpointin | High | 4/21/2026 |
| 1.14.3a1 | ## What's Changed ### Features - Add checkpoint and fork support to standalone agents ### Bug Fixes - Preserve thought_signature in Gemini streaming tool calls - Emit task_started on fork resume and redesign checkpoint TUI - Correct dry-run order and handle checked-out stale branch in devtools release - Use future dates in checkpoint prune tests to prevent time-dependent failures (#5543) ### Documentation - Update changelog and version for v1.14.2 ## Contributors @alex-clawd, @greysonlalond | High | 4/20/2026 |
| 1.14.2rc1 | ## What's Changed ### Bug Fixes - Fix handling of cyclic JSON schemas in MCP tool resolution - Fix vulnerability by bumping python-multipart to 0.0.26 - Fix vulnerability by bumping pypdf to 6.10.1 ### Documentation - Update changelog and version for v1.14.2a5 ## Contributors @greysonlalonde | High | 4/15/2026 |
| 1.14.2a5 | ## What's Changed ### Documentation - Update changelog and version for v1.14.2a4 ## Contributors @greysonlalonde | High | 4/15/2026 |
| 1.14.2a4 | ## What's Changed ### Features - Add resume hints to devtools release on failure ### Bug Fixes - Fix strict mode forwarding to Bedrock Converse API - Fix pytest version to 9.0.3 for security vulnerability GHSA-6w46-j5rx-g56g - Bump OpenAI lower bound to >=2.0.0 ### Documentation - Update changelog and version for v1.14.2a3 ## Contributors @greysonlalonde | Medium | 4/14/2026 |
| 1.14.2a3 | ## What's Changed ### Features - Add deploy validation CLI - Improve LLM initialization ergonomics ### Bug Fixes - Override pypdf and uv to patched versions for CVE-2026-40260 and GHSA-pjjw-68hj-v9mw - Upgrade requests to >=2.33.0 for CVE temp file vulnerability - Preserve Bedrock tool call arguments by removing truthy default - Sanitize tool schemas for strict mode - Deflake MemoryRecord embedding serialization test ### Documentation - Clean up enterprise A2A language - Add enterprise A2A fe | Medium | 4/13/2026 |
| 1.14.2a2 | ## What's Changed ### Features - Add checkpoint TUI with tree view, fork support, and editable inputs/outputs - Enrich LLM token tracking with reasoning tokens and cache creation tokens - Add `from_checkpoint` parameter to kickoff methods - Embed `crewai_version` in checkpoints with migration framework - Add checkpoint forking with lineage tracking ### Bug Fixes - Fix strict mode forwarding to Anthropic and Bedrock providers - Harden NL2SQLTool with read-only default, query validation, and par | Medium | 4/10/2026 |
| 1.14.2a1 | ## What's Changed ### Bug Fixes - Fix emission of flow_finished event after HITL resume - Fix cryptography version to 46.0.7 to address CVE-2026-39892 ### Refactoring - Refactor to use shared I18N_DEFAULT singleton ### Documentation - Update changelog and version for v1.14.1 ## Contributors @greysonlalonde | Medium | 4/8/2026 |
| 1.14.1 | ## What's Changed ### Features - Add async checkpoint TUI browser - Add aclose()/close() and async context manager to streaming outputs ### Bug Fixes - Fix regex for template pyproject.toml version bumps - Sanitize tool names in hook decorator filters - Fix checkpoint handlers registration when CheckpointConfig is created - Bump transformers to 5.5.0 to resolve CVE-2026-1839 - Remove FilteredStream stdout/stderr wrapper ### Documentation - Update changelog and version for v1.14.1rc1 ### Refa | Medium | 4/8/2026 |
| 1.14.1rc1 | ## What's Changed ### Features - Add async checkpoint TUI browser - Add aclose()/close() and async context manager to streaming outputs ### Bug Fixes - Fix template pyproject.toml version bumps using regex - Sanitize tool names in hook decorator filters - Bump transformers to 5.5.0 to resolve CVE-2026-1839 - Register checkpoint handlers when CheckpointConfig is created ### Refactoring - Replace hardcoded denylist with dynamic BaseTool field exclusion in spec gen - Replace regex with tomlkit i | Medium | 4/8/2026 |
| 1.14.0 | ## What's Changed ### Features - Add checkpoint list/info CLI commands - Add guardrail_type and name to distinguish traces - Add SqliteProvider for checkpoint storage - Add CheckpointConfig for automatic checkpointing - Implement runtime state checkpointing, event system, and executor refactor ### Bug Fixes - Add SSRF and path traversal protections - Add path and URL validation to RAG tools - Exclude embedding vectors from memory serialization to save tokens - Ensure output directory exists be | Medium | 4/7/2026 |
| 1.14.0a4 | ## What's Changed ### Features - Add guardrail_type and name to distinguish traces - Add SqliteProvider for checkpoint storage - Add CheckpointConfig for automatic checkpointing - Implement runtime state checkpointing, event system, and executor refactor ### Bug Fixes - Exclude embedding vectors from memory serialization to save tokens - Bump litellm to >=1.83.0 to address CVE-2026-35030 ### Documentation - Update quickstart and installation guides for improved clarity - Add storage providers | Medium | 4/7/2026 |
| 1.14.0a3 | ## What's Changed ### Documentation - Update changelog and version for v1.14.0a2 ## Contributors @joaomdmoura | Medium | 4/6/2026 |
| 1.14.0a2 | Release 1.14.0a2 | Medium | 4/6/2026 |
| 1.13.0 | ## What's Changed ### Features - Add RuntimeState RootModel for unified state serialization - Enhance event listener with new telemetry spans for skill and memory events - Add A2UI extension with v0.8/v0.9 support, schemas, and docs - Emit token usage data in LLMCallCompletedEvent - Auto-update deployment test repo during release - Improve enterprise release resilience and UX ### Bug Fixes - Add tool repository credentials to crewai install - Add tool repository credentials to uv build in tool | Medium | 4/2/2026 |
| 1.13.0a7 | ## What's Changed ### Features - Add A2UI extension with v0.8/v0.9 support, schemas, and docs ### Bug Fixes - Fix multimodal vision prefixes by adding GPT-5 and o-series ### Documentation - Update changelog and version for v1.13.0a6 ## Contributors @alex-clawd, @greysonlalonde, @joaomdmoura | Medium | 4/2/2026 |
| 1.13.0a6 | ## What's Changed ### Documentation - Fix RBAC permission levels to match actual UI options (#5210) - Update changelog and version for v1.13.0a5 (#5200) ### Performance - Reduce framework overhead by implementing a lazy event bus and skipping tracing when disabled (#5187) ## Contributors @alex-clawd, @joaomdmoura, @lucasgomide | Medium | 4/1/2026 |
| 1.13.0a5 | ## What's Changed ### Documentation - Update changelog and version for v1.13.0a4 ## Contributors @greysonlalonde, @joaomdmoura | Medium | 4/1/2026 |
| 1.13.0a4 | ## What's Changed ### Documentation - Update changelog and version for v1.13.0a3 ## Contributors @greysonlalonde | Medium | 3/31/2026 |
| 1.13.0a3 | ## What's Changed ### Features - Emit token usage data in LLMCallCompletedEvent - Extract and publish tool metadata to AMP ### Bug Fixes - Handle GPT-5.x models not supporting the `stop` API parameter ### Documentation - Fix inaccuracies in agent-capabilities across all languages - Add Agent Capabilities overview and improve Skills documentation - Add comprehensive SSO configuration guide - Update changelog and version for v1.13.0rc1 ### Refactoring - Convert Flow to Pydantic BaseModel - Con | Medium | 3/31/2026 |
| 1.13.0rc1 | ## What's Changed ### Documentation - Update changelog and version for v1.13.0a2 ## Contributors @greysonlalonde | Medium | 3/27/2026 |
| 1.13.0a2 | ## What's Changed ### Features - Auto-update deployment test repo during release - Improve enterprise release resilience and UX ### Documentation - Update changelog and version for v1.13.0a1 ## Contributors @greysonlalonde | Medium | 3/26/2026 |
| 1.13.0a1 | ## What's Changed ### Bug Fixes - Fix broken links in documentation workflow by pinning Node to LTS 22 - Bust the uv cache for freshly published packages in enterprise release ### Documentation - Add comprehensive RBAC permissions matrix and deployment guide - Update changelog and version for v1.12.2 ## Contributors @greysonlalonde, @iris-clawd, @joaomdmoura | Medium | 3/26/2026 |
| 1.12.2 | ## What's Changed ### Features - Add enterprise release phase to devtools release ### Bug Fixes - Preserve method return value as flow output for @human_feedback with emit ### Documentation - Update changelog and version for v1.12.1 - Revise security policy and reporting instructions ## Contributors @alex-clawd, @greysonlalonde, @joaomdmoura, @theCyberTech | Medium | 3/26/2026 |
| 1.12.1 | ## What's Changed ### Features - Add request_id to HumanFeedbackRequestedEvent - Add Qdrant Edge storage backend for memory system - Add docs-check command to analyze changes and generate docs with translations - Add Arabic language support to changelog and release tooling - Add modern standard Arabic translation of all documentation - Add logout command in CLI - Add agent skills - Implement automatic root_scope for hierarchical memory isolation - Implement native OpenAI-compatible providers (O | Medium | 3/26/2026 |
| 1.12.0 | ## What's Changed ### Features - Add Qdrant Edge storage backend for memory system - Add docs-check command to analyze changes and generate docs with translations - Add Arabic language support to changelog and release tooling - Add modern standard Arabic translation of all documentation - Add logout command in CLI - Implement agent skills - Implement automatic root_scope for hierarchical memory isolation - Implement native OpenAI-compatible providers (OpenRouter, DeepSeek, Ollama, vLLM, Cerebra | Medium | 3/26/2026 |
| 1.12.0a3 | ## What's Changed ### Bug Fixes - Fix bad credentials for traces batch push (404) - Resolve multiple bugs in HITL flow system ### Documentation - Update changelog and version for v1.12.0a2 ## Contributors @akaKuruma, @greysonlalonde | Medium | 3/25/2026 |
| 1.12.0a2 | ## What's Changed ### Features - Add Qdrant Edge storage backend for memory system ### Documentation - Update changelog and version for v1.12.0a1 ## Contributors @greysonlalonde | Medium | 3/25/2026 |
| 1.12.0a1 | ## What's Changed ### Features - Add docs-check command to analyze changes and generate docs with translations - Add Arabic language support to changelog and release tooling - Add modern standard Arabic translation of all documentation - Add native OpenAI-compatible providers (OpenRouter, DeepSeek, Ollama, vLLM, Cerebras, Dashscope) - Add agent skills - Add logout command in CLI - Implement automatic root_scope for hierarchical memory isolation ### Bug Fixes - Fix agent memory saving - Resolve | Medium | 3/25/2026 |
| 1.11.1 | ## What's Changed ### Features - Add flow_structure() serializer for Flow class introspection. ### Bug Fixes - Fix security vulnerabilities by bumping pypdf, tinytag, and langchain-core. - Preserve full LLM config across HITL resume for non-OpenAI providers. - Prevent path traversal in FileWriterTool. - Fix lock_store crash when redis package is not installed. - Pass cache_function from BaseTool to CrewStructuredTool. ### Documentation - Add publish custom tools guide with translations. - Upd | Medium | 3/23/2026 |
| 1.11.0 | ## What's Changed ### Documentation - Update changelog and version for v1.11.0rc2 ## Contributors @greysonlalonde | Low | 3/18/2026 |
| 1.11.0rc2 | ## What's Changed ### Bug Fixes - Enhance LLM response handling and serialization. - Upgrade vulnerable transitive dependencies (authlib, PyJWT, snowflake-connector-python). - Replace `os.system` with `subprocess.run` in unsafe mode pip install. ### Documentation - Update Exa Search Tool page with improved naming, description, and configuration options. - Add Custom MCP Servers in How-To Guide. - Update OTEL collectors documentation. - Update MCP documentation. - Update changelog and version f | Low | 3/17/2026 |
| 1.11.0rc1 | ## What's Changed ### Features - Add Plus API token authentication for a2a enterprise - Implement plan execute pattern ### Bug Fixes - Resolve code interpreter sandbox escape issue ### Documentation - Update changelog and version for v1.10.2rc2 ## Contributors @Copilot, @greysonlalonde, @lorenzejay, @theCyberTech | Low | 3/16/2026 |
| 1.10.2rc2 | ## What's Changed ### Bug Fixes - Remove exclusive locks from read-only storage operations ### Documentation - Update changelog and version for v1.10.2rc1 ## Contributors @greysonlalonde | Low | 3/14/2026 |
| 1.10.2rc1 | ## What's Changed ### Features - Add release command and trigger PyPI publish ### Bug Fixes - Fix cross-process and thread-safe locking to unprotected I/O - Propagate contextvars across all thread and executor boundaries - Propagate ContextVars into async task threads ### Documentation - Update changelog and version for v1.10.2a1 ## Contributors @danglies007, @greysonlalonde | Low | 3/13/2026 |
| 1.10.2a1 | ## What's Changed ### Features - Add support for tool search by saving tokens and dynamically injecting appropriate tools during execution. - Introduce more Brave Search tools. - Create action for nightly releases. ### Bug Fixes - Fix LockException under concurrent multi-process execution. - Resolve grouping of parallel tool results in a single user message. - Address MCP tools resolutions and eliminate all shared mutable connections. - Fix update of LLM parameter handling in the human_feedbac | Low | 3/11/2026 |
| 1.10.1 | ## What's Changed ### 🚀 Features - **Upgrade Gemini GenAI** ### 🐛 Bug Fixes - Adjust executor listener value to avoid recursion - Group parallel function response parts in a single `Content` object in Gemini - Surface thought output from thinking models in Gemini - Load MCP and platform tools when agent tools are `None` - Support Jupyter environments with running event loops in A2A - Use anonymous ID for ephemeral traces - Conditionally pass plus header - Skip signal handler reg | Low | 3/4/2026 |
| 1.10.1a1 | ## What's Changed ### Features - Implement asynchronous invocation support in step callback methods - Implement lazy loading for heavy dependencies in Memory module ### Documentation - Update changelog and version for v1.10.0 ### Refactoring - Refactor step callback methods to support asynchronous invocation - Refactor to implement lazy loading for heavy dependencies in Memory module ### Bug Fixes - Fix branch for release notes ## Contributors @greysonlalonde, @joaomdmoura | Low | 2/27/2026 |
| 1.10.0 | ## What's Changed ### Features - Enhance MCP tool resolution and related events - Update lancedb version and add lance-namespace packages - Enhance JSON argument parsing and validation in CrewAgentExecutor and BaseTool - Migrate CLI HTTP client from requests to httpx - Add versioned documentation - Add yanked detection for version notes - Implement user input handling in Flows - Enhance HITL self-loop functionality in human feedback integration tests - Add started_event_id and set in eventbus - | Low | 2/27/2026 |
| 1.10.0a1 | ## What's Changed * declare `stagehand` package as dep for StagehandTool by @thiagomoretto in https://github.com/crewAIInc/crewAI/pull/4336 * fix: flow tracking by @greysonlalonde in https://github.com/crewAIInc/crewAI/pull/4335 * feat: auto update tools.specs by @lucasgomide in https://github.com/crewAIInc/crewAI/pull/4341 * adds additional brave-search-api params by @jonathansampson in https://github.com/crewAIInc/crewAI/pull/4321 * fix: enforce additionalProperties=false in schemas by @greyso | Low | 2/19/2026 |
| 1.9.3 | ## What's Changed Features * feat: add a2a liteagent, auth, transport negotiation, and file support Bug Fixes: * fix: improve output handling and response model integration in agents | Low | 1/30/2026 |
| 1.9.2 | ## What's Changed * fix: ensure verbosity flag is applied b * fix: use response_json_schema * fix: tool response pt2 | Low | 1/29/2026 |
| 1.9.1 | ## What's Changed ### Features - Implement before and after tool call hooks in CrewAgentExecutor - Add structured outputs and response_format support across providers ### Bug Fixes - Correct tool-calling content handling and schema serialization ## Contributors @greysonlalonde, @lorenzejay | Low | 1/28/2026 |
| 1.9.0 | ## What's Changed ### Features - Add structured outputs and response_format support across providers - Add response_id in streaming response - Add event ordering and parent-child hierarchy - Add Keycloak SSO provider support - Add native multimodal file handling; OpenAI responses API - Add a2a task execution utilities - Add a2a server config and agent card generation - Add additional a2a events and enrich event metadata - Add additional a2a transports - Add Galileo to integrations p | Low | 1/27/2026 |
| 1.8.1 | ## What's Changed ### Features - Add A2A task execution utilities - Add A2A server configuration and agent card generation - Add additional A2A transports - Add Galileo to integrations page ### Bug Fixes - Enhance Azure model stop word support detection - Increase frame inspection depth to detect `parent_flow` - Unlink task in execution spans - Improve error handling for HumanFeedbackPending in flow execution - Handle HumanFeedbackPending in flow error management ### Documentation - Update A2 | Low | 1/15/2026 |
| 1.8.0 | ## What's Changed ### Features - Add native async chain for a2a - Add a2a update mechanisms (poll/stream/push) with handlers and config - Introduce global flow configuration for human-in-the-loop feedback - Add streaming tool call events and fix provider ID tracking - Introduce production-ready Flows and Crews architecture - Add HITL for Flows - Improve EventListener and TraceCollectionListener for enhanced event handling ### Bug Fixes - Handle missing a2a dependency as optional - Correct erro | Low | 1/8/2026 |
| 1.7.2 | ## What's Changed ### Bug Fixes - Resolve connection issues (#4129) ### Documentation - Update api-reference/status docs page ## Contributors @greysonlalonde, @heitorado, @lorenzejay, @lucasgomide | Low | 12/19/2025 |
| 1.7.1 | ## What's Changed ### Improvements - Add `--no-commit` flag to bump command - Use JSON schema for tool argument serialization ### Bug Fixes - Fix error message display from response when tool repository login fails - Fix graceful termination of future when executing a task asynchronously - Fix task ordering by adding index - Fix platform compatibility checks for Windows signals - Fix RPM controller timer to prevent process hang - Fix token usage recording and validate response mode | Low | 12/16/2025 |
| 1.7.0 | ## What's Changed ### Features - Add async flow kickoff - Add async crew support - Add async task support - Add async knowledge support - Add async memory support - Add async support for tools and agent executor; improve typing and docs - Implement a2a extensions API and async agent card caching; fix task propagation & streaming - Add native async tool support - Add async llm support - Create sys event types and handler ### Bug Fixes - Fix issue to ensure nonetypes are not passed to otel - Fix | Low | 12/9/2025 |