CrewAI
AI & LLMsFramework for orchestrating role-playing, autonomous AI agents. By fostering collaborative intelligence, CrewAI empowers agents to work together seamlessly, tackling complex tasks.
Release History
1.15.27 fixes11 featuresThis release introduces significant new features for flow management, including dynamic model pulling and inline skill definitions. It also addresses several bug fixes related to caching, dependency vulnerabilities, and flow execution.
1.15.2a21 fix5 featuresThis release introduces new features related to flow agents and bedrock extras, alongside a bug fix rejecting self-listening flow methods.
1.15.2a11 fix5 featuresThis release introduces new features like inline skill definitions and flow protocol support, alongside a fix for documentation navigation issues.
1.15.14 fixes3 featuresThis release introduces new features like Git initialization for generated projects and explicit CrewAI project definitions. Several bugs were fixed, including issues with deployment links, JSON template rendering, and SSRF vulnerabilities.
1.15.1a13 fixes3 featuresThis release introduces new telemetry tracking, enforces explicit project definitions, and fixes several bugs related to JSON rendering and security vulnerabilities.
1.15.07 fixes10 featuresThis release introduces significant features for conversational flows, including CLI support and declarative loading, alongside various bug fixes and internal refactoring for better flow state management.
1.14.8a51 fix1 featureThis release introduces support for declarative refs across flows and crews and resolves an issue with JSON schema flow state kickoff inputs.
1.14.8a42 fixes1 featureThis release introduces support for conversational flows in the CLI TUI and includes fixes for symlink path traversal and declarative flow definition validation.
1.14.8a31 fix7 featuresThis release introduces significant improvements to declarative flow loading and CLI experience, alongside better UX for crew execution and typed output schemas for tools.
1.14.8a22 featuresThis release introduces validation for Flow CEL expressions upon definition loading and adds support for single agent actions in Flow definitions. Documentation updates include a new Datadog integration guide.
1.14.8a11 fix1 featureThis release introduces an optional if expression for each.do steps and resolves issues related to JSON crew functionality.
1.14.8a3 fixes12 featuresThis release introduces significant features centered around FlowDefinition, enabling script/code block actions, crew actions, and 'each' composite actions. It also implements DMN mode support and introduces JSON-first crew projects.
1.14.79 fixes8 featuresThis release introduces significant extensibility with pluggable backends and a new chat API for conversational flows. It also includes numerous bug fixes, particularly around state restoration and Snowflake integration, alongside performance improvements for imports.
1.14.7rc21 fixThis release primarily focuses on a bug fix related to snapshot restoration, ensuring live snapshots are not replayed as resumes.
1.14.7rc13 fixes3 featuresThis release introduces enhanced prompt handling and state management capabilities, alongside fixes for runtime state isolation and telemetry setup.
1.14.7a42 featuresThis release introduces significant architectural updates by migrating the @listen/@router runtime and adding pluggable default backends for core components.
1.14.7a32 fixesThis release focuses on bug fixes, including resolving CVEs and correcting an exposure issue on AgentExecutor, alongside a minor refactoring to update how '@start' reads definitions.
1.14.7a28 featuresThis release introduces support for conversational flow traces, surfaces detailed LLM event information, and refactors the Flow DSL into focused decorator modules. It also includes documentation updates for new guides and deployment methods.
1.14.7a15 fixes4 featuresThis release introduces support for crew trained agents and the Snowflake Cortex LLM provider, alongside several bug fixes, notably improving CLI stability and Snowflake Claude integration.
1.14.66 fixes3 featuresThis release introduces enhancements to environment variable handling in StdioTransport and planning configuration, alongside several bug fixes related to structured output leaks and checkpointing reliability. The Skills Repository has also been moved to an experimental status.
1.14.6a26 fixes4 featuresThis release introduces enhancements to StdioTransport and planning configurations, alongside several bug fixes related to structured output leaks and checkpointing reliability. Documentation has also been updated for Agent Control Plane and checkpointing.
1.14.6a13 fixes2 featuresThis release introduces the Skills Repository feature and enhances enterprise release note generation. It also includes several bug fixes, notably addressing a security issue by bumping the idna dependency.
1.14.59 fixes3 featuresThis release introduces improvements to sandbox tools and kickoff parameters, deprecates `CrewAgentExecutor` in favor of `AgentExecutor`, and fixes several bugs including a memory leak in `git.py`.
1.14.5a7BreakingThis release primarily focuses on documentation updates and introduces a breaking change by deprecating the "function_calling_llm" field.
1.14.5a63 fixes1 featureThis release primarily focuses on bug fixes, including resolving an issue with streamed tool calls and updating the langsmith dependency to address a security vulnerability. Documentation for TavilyGetResearch was also added.
1.14.5a55 fixes1 featureThis release introduces improvements to Daytona sandbox tools and deprecates CrewAgentExecutor in favor of AgentExecutor. Several security patches and documentation updates were also included.
1.14.5a41 fix1 featureThis release primarily updates LLM listings and resolves a dependency conflict by adjusting package placements.
1.14.5a32 fixesThis release fixes an issue with the status endpoint path and updates the gitpython dependency for security. The CLI has been extracted into a new standalone package.
1.14.5a29 fixesThis release focuses on bug fixes, improving output handling in various scenarios, and ensuring correct token counting. Key fixes involve output restoration, async flushing, and preventing incorrect final answers.
1.14.5a12 fixes2 featuresThis release introduces a new kickoff parameter 'restore_from_state_id' and updates the ExaSearchTool naming convention. Several minor bug fixes related to release flow and tracing were also implemented.
1.14.413 fixes6 featuresThis release introduces several new features, including custom persistence key support and expanded search/research tools via Tavily and You.com. Numerous bug fixes address issues related to JSON handling, tool call preservation, and agent execution.
1.14.4a23 fixes3 featuresThis release introduces support for custom persistence keys and enhances Azure OpenAI integration with Responses API support and credential forwarding. Several minor bug fixes address LLM handling and tool execution.
1.14.4a18 fixesThis release focuses on stability and security by fixing several bugs related to LLM interactions, executor state management, and dependency updates, including a bump to litellm for an SSTI fix. New documentation for various sandbox tools has also been added.
1.14.314 fixes6 featuresThis release introduces significant new features, including checkpoint lifecycle events, e2b support, and Bedrock V4 integration. It also includes numerous bug fixes related to serialization, checkpointing, and dependency upgrades for security.
1.14.3a31 fix2 featuresThis release introduces support for e2b and implements a fallback to DefaultAzureCredential. It also includes a security fix by upgrading the lxml dependency.
1.14.3a25 fixes4 featuresThis release introduces support for Bedrock V4 and Daytona sandbox tools, alongside new 'Build with AI' documentation features. Several bugs related to event propagation, serialization, and guardrail retries have also been fixed.
1.14.3a14 fixes1 featureThis release introduces checkpoint and fork support for standalone agents and includes several bug fixes related to Gemini streaming, checkpointing, and devtools.
1.14.210 fixes7 featuresThis release introduces significant new features around checkpoint management, including resume, diff, and forking capabilities. It also addresses several bugs and patches security vulnerabilities across multiple dependencies.
1.14.2rc13 fixesThis release primarily focuses on security fixes by updating dependencies python-multipart and pypdf, and resolves an issue with cyclic JSON schema handling in MCP tool resolution.
1.14.2a5This release primarily updates the changelog and version number to v1.14.2a4.
1.14.2a43 fixes1 featureThis release introduces resume hints for devtools failure releases and addresses several bugs, including strict mode forwarding to Bedrock Converse API and a security vulnerability in pytest.
1.14.2a35 fixes2 featuresThis release introduces a new deploy validation CLI and improves LLM initialization ergonomics, alongside several critical security and stability fixes.
1.14.2a22 fixes5 featuresThis release introduces significant enhancements to checkpoint management, including a new TUI and forking capabilities, alongside improvements to LLM token tracking and tool security.
1.14.2a12 fixesThis release primarily focuses on bug fixes, including resolving an event emission issue after HITL resume and updating the cryptography dependency to patch a security vulnerability.
1.14.15 fixes2 featuresThis release introduces an async checkpoint TUI browser and adds closing methods/context managers for streaming outputs. It also includes several bug fixes, notably resolving a CVE by bumping the transformers dependency.
1.14.1rc14 fixes2 featuresThis release introduces an async checkpoint TUI browser and improved streaming output management. It also includes several bug fixes, notably resolving a CVE by bumping the transformers library.
1.14.06 fixes5 featuresThis release introduces significant features around checkpointing, including configuration and runtime state management, alongside important security fixes and dependency updates.
1.14.0a42 fixes4 featuresThis release introduces significant features like runtime state checkpointing and a new SqliteProvider for storage. It also removes the CodeInterpreterTool and addresses a security vulnerability via a dependency bump.
1.14.0a3This release primarily updates the changelog and version number to v1.14.0a2.
1.14.0a21.13.0Breaking9 fixes6 featuresThis release introduces a unified RuntimeState RootModel, enhances telemetry for events, and adds A2UI extension support. Several core components like Flow and LLM classes were refactored to use Pydantic BaseModels, and various bugs related to credentials, model handling, and RBAC were fixed.
1.13.0a71 fix1 featureThis release introduces the A2UI extension with support for v0.8/v0.9 and fixes multimodal vision prefixes by including GPT-5 and o-series models.
1.13.0a61 fixThis release focuses on documentation fixes and performance improvements by reducing framework overhead through lazy event bus implementation and skipping tracing when disabled.
1.13.0a5This release primarily updates the changelog and version number to v1.13.0a4.
1.13.0a4This release primarily updates the changelog and version information to v1.13.0a3.
1.13.0a31 fix2 featuresThis release introduces new features for emitting token usage data and publishing tool metadata. It also includes bug fixes for handling GPT-5.x models and significant internal refactoring converting core components to Pydantic BaseModels.
1.13.0rc1This release primarily updates the changelog and version number to v1.13.0a2.
1.13.0a22 featuresThis release focuses on internal improvements, including auto-updating the deployment test repository and enhancing enterprise release resilience and user experience.
1.13.0a12 fixesThis release focuses on maintenance, fixing issues in the documentation workflow and enterprise package publishing, and updating documentation with an RBAC matrix.
1.12.21 fix1 featureThis release introduces the enterprise release phase for devtools and fixes a bug related to preserving method return values in human feedback flows.
1.12.19 fixes9 featuresThis release introduces significant new features like agent skills, expanded OpenAI-compatible provider support, and Qdrant Edge storage. It also includes numerous bug fixes, particularly around type checking and memory handling.
1.12.010 fixes8 featuresThis release introduces significant new features, including Qdrant Edge support, agent skills, and native support for numerous OpenAI-compatible providers. It also includes extensive bug fixes, particularly around mypy type checking and memory handling.
1.12.0a32 fixesThis release focuses on bug fixes, specifically addressing credential issues for trace batch pushes and resolving several bugs within the HITL flow system.
1.12.0a21 featureThis release introduces the Qdrant Edge storage backend for the memory system and updates documentation.
1.12.0a18 fixes7 featuresThis release introduces significant new features like native OpenAI-compatible provider support and agent skills, alongside extensive bug fixes, particularly resolving mypy errors across packages. The internal plumbing related to LiteLLM has also been decoupled.
1.11.15 fixes1 featureThis release introduces flow structure serialization and addresses several bugs, including security vulnerabilities and stability fixes for tool handling and configuration persistence.
1.11.0This release primarily updates the changelog and version number to v1.11.0rc2.
1.11.0rc23 fixesThis release focuses on security and stability by upgrading vulnerable dependencies and improving LLM response handling. Documentation for several tools and guides has also been updated.
1.11.0rc11 fix2 featuresThis release introduces Plus API token authentication and implements the plan execute pattern, alongside fixing a critical code interpreter sandbox escape issue.
1.10.2rc21 fixThis release primarily focuses on fixing an issue by removing exclusive locks from read-only storage operations.
1.10.2rc13 fixes1 featureThis release introduces a new release command for PyPI publishing and includes several bug fixes related to thread safety and ContextVar propagation.
1.10.2a17 fixes3 featuresThis release introduces token-saving tool search capabilities and adds support for more Brave Search tools. It also includes several bug fixes addressing concurrency issues, tool result grouping, and dependency vulnerabilities.
1.10.111 fixes1 featureThis release upgrades the Gemini GenAI integration and addresses several bugs, including resolving critical security alerts by upgrading the pypdf dependency.
1.10.1a11 fix2 featuresThis release introduces asynchronous invocation support for step callback methods and implements lazy loading for heavy dependencies within the Memory module.
1.10.013 fixes10 featuresThis release introduces significant feature enhancements, including improved tool resolution, JSON argument parsing, and user input handling in Flows. Numerous bug fixes address issues related to tool validation, schema handling, and flow persistence.
1.10.0a1Breaking17 fixes11 featuresThis release introduces significant architectural refactoring, including a New Unified Memory System and provider pattern extraction, alongside numerous bug fixes for flow tracking, event handling, and tool usage. It also adds features like version checking and improved HITL support.
1.9.32 fixes4 featuresThis release introduces several new features including a2a liteagent, enhanced authentication, transport negotiation, and file support, alongside bug fixes for agent output handling and response model integration.
1.9.23 fixesThis release focuses on minor fixes, including ensuring the verbosity flag is applied and correcting issues related to response handling.
1.9.11 fix2 featuresThis release introduces before and after tool call hooks in CrewAgentExecutor and adds structured outputs and response_format support across providers, alongside a fix for tool-calling content handling.
1.9.08 fixes11 featuresThis release introduces significant new features including structured outputs, response_format support, native multimodal file handling, and Keycloak SSO. Several bug fixes address issues related to Bedrock, Google Vertex API, and flow error management.
1.8.15 fixes4 featuresThis release introduces significant features related to A2A (Agent-to-Agent) communication, including task execution utilities and server configuration. Several bug fixes address issues in flow execution and error handling.
1.8.03 fixes7 featuresThis release introduces production-ready Flows and Crews architecture, featuring native async agent-to-agent communication and human-in-the-loop feedback mechanisms.
1.7.21 fixThis release focuses on resolving connection issues and updating the API reference documentation.
1.7.16 fixes5 featuresThis release introduces a --no-commit flag for the bump command, implements JSON schema for tool serialization, and provides several bug fixes related to async task execution and platform compatibility.
1.7.07 fixes10 featuresThis release introduces comprehensive native async support across the entire framework, including flows, agents, tools, and memory. It also includes critical bug fixes for OpenTelemetry integration, token store deadlocks, and Anthropic tool support.
1.6.15 fixes1 featureThis release focuses on stability improvements across the LLM and RagTool modules, including fixes for async execution and configuration resetting.
1.6.05 fixes5 featuresThis release introduces streaming support for flows and crews, adds Gemini 3 Pro Preview support, and includes several bug fixes for RAG tools and OpenAI parameter handling.
0.203.21 fixThis is a hotfix release updating the crewAI version from 0.203.1 to 0.203.2.
1.5.03 fixes5 featuresThis release introduces LLM call hooks for CrewAgentExecutor, expands data exposure in Task and Agent outputs, and improves tracing instrumentation and documentation.
1.4.12 fixesThis release focuses on bug fixes for agent iteration handling and LLM provider routing logic.
1.4.0Breaking7 fixes6 featuresThis release introduces first-class MCP support and LLM message interceptor hooks, while refactoring embedding configurations and fixing critical flow state and caching issues.
1.3.0Breaking2 fixes3 featuresThis release focuses on refactoring flow handling and tool documentation, specifically renaming embedding parameters and enhancing the Qdrant and Firecrawl tools.
1.2.12 featuresThis release introduces Datadog integration support and enables apps and MCPs within liteagent, alongside updated documentation for platform tool environment variables.
1.2.0Breaking4 fixesThis release focuses on maintenance by updating default LLM models, improving logging, and refining flow visualization, while also removing the unused aisuite dependency.
1.1.03 fixes3 featuresThis release introduces support for multiple LLM providers in InternalInstructor, adds a mypy plugin base, and improves typing for CrewBase alongside several bug fixes.
1.0.07 fixes3 featuresCrewAI reaches version 1.0.0, introducing enhanced guardrail handling for Agents and credential injection for tools, alongside several stability fixes for Flows and Docker environments.
1.0.0b33 fixes6 featuresThis release focuses on enhancing LLM completion classes (Bedrock, Gemini, Anthropic) with better parameter support and refactoring the project module to a metaclass for improved typing.
1.0.0b23 fixes3 featuresThis release focuses on enhancing the OpenAICompletion class, improving event bus thread safety, and fixing critical bugs related to input availability and JWT decoding.
1.0.0b14 fixes3 featuresThis release introduces Bedrock LLM integration and enhances OpenAICompletion parameters while improving event bus thread safety. It also includes several bug fixes related to JWT decoding, input availability, and task handling.
0.203.12 fixes1 featureThis release focuses on core improvements, including a fix for tool repository credential injection and enhanced JWT validation with a 10-second leeway.
Common Errors
ModuleNotFoundError3 reportsModuleNotFoundError in CrewAI usually indicates a missing or incorrectly installed dependency. To fix this, ensure you've installed all required packages using `pip install crewai` (or `pip install crewai[tools]` if you need the tools). For specific missing modules like `litellm`, install them directly using `pip install litellm`.
FileNotFoundError3 reportsFileNotFoundError in crewai usually arises from incorrect file paths, especially when the program cannot locate a specified file or directory, often due to relative paths or operating system differences. Fix this by using absolute paths where possible, validating file existence with `os.path.exists()` before access, and normalizing paths using `os.path.normpath()` to handle OS differences, especially on Windows with long paths by using the `\\?\` prefix.
OutputParserException2 reportsOutputParserException in CrewAI arises when the LLM's output doesn't conform to the expected format, causing parsing failures. Correct this by ensuring the `format_instructions` in your prompt are very clear and align with your OutputParser's requirements. Furthermore, implement robust error handling within the parsing logic to gracefully manage unexpected formats, potentially returning a default or partially parsed response.
BadRequestError2 reportsBadRequestError in crewAI often arises from invalid input sent to the LLM provider, such as empty content or malformed prompts. To fix this, ensure prompt strings are properly formatted and non-empty before sending them to the LLM, and strip any trailing whitespace. Validation and sanitization of input strings will prevent such errors.
UnboundLocalError1 reportThe UnboundLocalError occurs when a variable is used before it's assigned a value within a local scope, often in if/else blocks or loops. To fix this, ensure the variable is initialized with a default value before the conditional logic or loop where it might be used without being assigned, guaranteeing it always has a valid value. A common quick fix is assigning None to the variable before the conditional.
RateLimitError1 reportRateLimitError in crewAI usually occurs when the language model API is called too frequently, exceeding the allowed requests per time unit. Implement exponential backoff with retry logic around API calls to pause and retry after rate limits are hit. Consider using a rate limiting library or adjusting the agent's task execution frequency to stay within the API's usage limits.
Related AI & LLMs Packages
AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mission is to provide the tools, so that you can focus on what matters.
Get up and running with OpenAI gpt-oss, DeepSeek-R1, Gemma 3 and other models.
🦜🔗 The platform for reliable agents.
The most powerful and modular diffusion model GUI, api and backend with a graph/nodes interface.
LLM inference in C/C++
GPT4All: Run Local LLMs on Any Device. Open-source and available for commercial use.
Subscribe to Updates
Get notified when new versions are released