crewai-files

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 on this page — 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

crewai-files on PyPI

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

Evidence: crewai_files-1.15.16-py3-none-any.whl

Tags

More Application Frameworks packages

Further reading