---
id: crewai-core
version: "1.15.16"
license: unclear
license_treatment: unclear
maintenance: active
---

# crewai-core — Shared utilities for CrewAI — version, paths, user-data, telemetry, printer.

License: unclear · Maintenance: active · Downloads: 4.2M/mo

## What it is and what it does

CrewAI Core is a foundational utility package that supplies shared infrastructure for the CrewAI multi-agent framework. It handles version management, user data paths, telemetry collection and export (via OpenTelemetry), and configuration printing. The package depends on cryptography, JWT handling, HTTP clients, and structured data validation through Pydantic, suggesting it manages authentication, API communication, and configuration serialization for agent workflows.

This is a low-level component designed to support CrewAI's Crews (autonomous agent teams) and Flows (event-driven workflows) rather than a standalone tool. It provides the plumbing that allows agents to report metrics, logs, and traces to observability systems, and manages paths and versioning across the framework. Most developers will encounter it as a transitive dependency when installing the main crewai package.

Use it for:

- Building observability and monitoring into multi-agent systems by leveraging the telemetry infrastructure.
- Accessing shared configuration, version info, and user data paths when extending or integrating CrewAI.
- Enabling OpenTelemetry-based tracing and metrics export for production agent deployments.
- Managing authentication and secure communication in agent workflows through cryptography and JWT utilities.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides shared utilities, telemetry, and configuration infrastructure for CrewAI multi-agent workflows—version management, user data paths, and observability hooks.

No—install crewai-core only as a dependency of the main crewai package. It is a foundational utility with no direct user-facing API; installing it standalone offers no benefit. If you are building multi-agent workflows, install crewai instead, which will pull in crewai-core automatically. Verify the unclear license terms before use in restricted contexts.

## Install

pip install crewai-core
uv add crewai-core
poetry add crewai-core

## Installing crewai-core

Before you install: Low install friction with a pure-Python wheel distribution. Active maintenance with a recent release and high repository engagement (57079 stars), though the package is a foundational utility rather than a standalone tool.

License in practice: License treatment is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify licensing terms before use in proprietary or restricted contexts.

Quickstart:

pip install crewai-core

from crewai_core import __version__
print(__version__)

Requires Python >=3.10 <3.14; intended as a dependency of crewai rather than direct use.

Verify before relying:

- Whether crewai-core is meant for direct application use or exclusively as an internal dependency of the main crewai package.
- Specific telemetry and observability capabilities beyond the summary description.
- License terms and conditions for use in commercial or proprietary projects.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 4.2M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

crewai core utilities, multi-agent framework foundation, agent telemetry and observability, workflow configuration management, crewai shared infrastructure, multi-agent-framework, observability, internal-dependency

[View on SkillFed](https://skillfed.io/packages/crewai-core) · [View on PyPI](https://pypi.org/project/crewai-core/)