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

# crewai-files — File handling utilities for CrewAI multimodal inputs

License: unclear · Maintenance: active · Downloads: 124.5K/mo

## What it is and what it does

crewai-files is a file abstraction layer for CrewAI agent workflows, wrapping multimodal file types (images, PDFs, text, audio, video) into typed objects that can be passed directly to crew tasks and agents. It handles file type detection automatically or via explicit type classes, abstracting away the underlying media handling complexity.

The package depends on aiocache, aiofiles, av, pillow, pypdf, python-magic, and tinytag to support its media operations. It's designed as a utility for CrewAI workflows where agents need to process diverse file formats as structured inputs, reducing boilerplate around file loading and type management.

Use it for:

- Pass images to agents for visual analysis tasks without manual format detection or PIL setup.
- Feed PDF documents to agents for extraction, summarization, or content analysis workflows.
- Supply audio or video files to agent tasks for transcription, metadata extraction, or media analysis.
- Auto-detect file types in batch processing pipelines where mixed media formats are common.
- Integrate file inputs into CrewAI task definitions with minimal setup overhead.

## Worth the install?

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

Provides file type abstractions for CrewAI multimodal inputs, auto-detecting and handling images, PDFs, text, audio, and video files for agent task processing.

Yes, if you are building CrewAI agents that consume multimodal files. The package is actively maintained, has low install friction, and directly solves the file-handling boilerplate problem for CrewAI workflows. However, verify the license before use in proprietary projects, and confirm system media library availability for your target file types.

## Install

pip install crewai-files
uv add crewai-files
poetry add crewai-files

## Installing crewai-files

Before you install: Low install friction with a pure-Python wheel and seven runtime dependencies covering media handling. Active maintenance with a release on 2026-08-14.

License in practice: License treatment is unclear—no SPDX identifier or raw license text is available. Verify the actual license before using in proprietary or copyleft-sensitive projects.

Quickstart:

pip install crewai-files

from crewai_files import File, ImageFile, PDFFile

image = ImageFile(source="chart.png")
pdf = PDFFile(source="report.pdf")

Requires Python 3.10 or later. System libraries for media codecs (libmagic, ffmpeg-related) may be needed depending on file types processed.

Verify before relying:

- Whether system-level media libraries (e.g., libmagic, ffmpeg) must be pre-installed for all file types or only specific ones.
- Exact license under which crewai-files is distributed and any redistribution constraints.

## Package facts

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

## Tags

crewai file handling, multimodal file processing, image pdf audio video file wrapper, crewai input files, file type detection agents, crewai-integration, multimodal-files

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