Project Links

Meta

Author: Greyson LaLonde

Requires Python: <3.14,>=3.10

Classifiers

crewai-files

File handling utilities for CrewAI multimodal inputs.

Supported File Types

ImageFile - PNG, JPEG, GIF, WebP
PDFFile - PDF documents
TextFile - Plain text files
AudioFile - MP3, WAV, FLAC, OGG, M4A
VideoFile - MP4, WebM, MOV, AVI

Usage

from crewai_files import File, ImageFile, PDFFile

# Auto-detect file type
file = File(source="document.pdf")  # Resolves to PDFFile

# Or use specific types
image = ImageFile(source="chart.png")
pdf = PDFFile(source="report.pdf")

Passing Files to Crews

crew.kickoff(
    input_files={"chart": ImageFile(source="chart.png")}
)

Passing Files to Tasks

task = Task(
    description="Analyze the chart",
    expected_output="Analysis",
    agent=agent,
    input_files=[ImageFile(source="chart.png")],
)

1.15.9 Jul 30, 2026

1.15.9.dev20260730 Jul 30, 2026

1.15.8 Jul 28, 2026

1.15.8.dev20260729 Jul 29, 2026

1.15.7 Jul 26, 2026

1.15.7a1 Jul 26, 2026

1.15.7.dev20260728 Jul 28, 2026

1.15.7.dev20260727 Jul 27, 2026

1.15.6 Jul 24, 2026

1.15.6.dev20260725 Jul 25, 2026

1.15.5 Jul 20, 2026

1.15.5.dev20260723 Jul 23, 2026

1.15.5.dev20260722 Jul 22, 2026

1.15.5.dev20260721 Jul 21, 2026

1.15.4 Jul 17, 2026

1.15.4.dev20260718 Jul 18, 2026

1.15.3 Jul 16, 2026

1.15.3a2 Jul 16, 2026

1.15.3a1 Jul 16, 2026

1.15.3.dev20260717 Jul 17, 2026

1.15.2 Jul 08, 2026

1.15.2a2 Jul 01, 2026

1.15.2a2.dev20260707 Jul 07, 2026

1.15.2a2.dev20260703 Jul 03, 2026

1.15.2a2.dev20260702 Jul 02, 2026

1.15.2a1 Jun 30, 2026

1.15.2a1.dev20260701 Jul 01, 2026

1.15.2.dev20260716 Jul 16, 2026

1.15.2.dev20260715 Jul 15, 2026

1.15.2.dev20260714 Jul 14, 2026

1.15.2.dev20260711 Jul 11, 2026

1.15.2.dev20260710 Jul 10, 2026

1.15.2.dev20260708 Jul 08, 2026

1.15.1 Jun 27, 2026

1.15.1a1 Jun 26, 2026

1.15.1.dev20260630 Jun 30, 2026

1.15.1.dev20260628 Jun 28, 2026

1.15.1.dev20260627 Jun 27, 2026

1.15.0 Jun 25, 2026

1.15.0.dev20260626 Jun 26, 2026

1.14.8a5 Jun 25, 2026

1.14.8a5.dev20260625 Jun 25, 2026

1.14.8a4 Jun 24, 2026

1.14.8a3 Jun 23, 2026

1.14.8a3.dev20260624 Jun 24, 2026

1.14.8a2 Jun 18, 2026

1.14.8a2.dev20260623 Jun 23, 2026

1.14.8a2.dev20260620 Jun 20, 2026

1.14.8a2.dev20260619 Jun 19, 2026

1.14.8a1 Jun 18, 2026

1.14.8a0 Jun 18, 2026

1.14.8a0.dev20260618 Jun 18, 2026

1.14.7 Jun 11, 2026

1.14.7rc2 Jun 11, 2026

1.14.7rc2.dev20260611 Jun 11, 2026

1.14.7rc1 Jun 11, 2026

1.14.7a4 Jun 09, 2026

1.14.7a4.dev20260610 Jun 10, 2026

1.14.7a3 Jun 09, 2026

1.14.7a3.dev20260609 Jun 09, 2026

1.14.7a2 Jun 05, 2026

1.14.7a2.dev20260606 Jun 06, 2026

1.14.7a1 Jun 03, 2026

1.14.7a1.dev20260605 Jun 05, 2026

1.14.7a1.dev20260604 Jun 04, 2026

1.14.7.dev20260617 Jun 17, 2026

1.14.7.dev20260616 Jun 16, 2026

1.14.7.dev20260615 Jun 15, 2026

1.14.7.dev20260614 Jun 14, 2026

1.14.7.dev20260613 Jun 13, 2026

1.14.7.dev20260612 Jun 12, 2026

1.14.6 May 28, 2026

1.14.6a2 May 27, 2026

1.14.6a2.dev20260528 May 28, 2026

1.14.6a1 May 21, 2026

1.14.6a1.dev20260527 May 27, 2026

1.14.6a1.dev20260526 May 26, 2026

1.14.6a1.dev20260523 May 23, 2026

1.14.6a1.dev20260522 May 22, 2026

1.14.6a1.dev20260521 May 21, 2026

1.14.6.dev20260603 Jun 03, 2026

1.14.6.dev20260602 Jun 02, 2026

1.14.6.dev20260601 Jun 01, 2026

1.14.6.dev20260530 May 30, 2026

1.14.6.dev20260529 May 29, 2026

1.14.5 May 18, 2026

1.14.5a7 May 18, 2026

1.14.5a6 May 15, 2026

1.14.5a6.dev20260516 May 16, 2026

1.14.5a5 May 12, 2026

1.14.5a5.dev20260514 May 14, 2026

1.14.5a5.dev20260513 May 13, 2026

1.14.5a4 May 08, 2026

1.14.5a4.dev20260512 May 12, 2026

1.14.5a4.dev20260509 May 09, 2026

1.14.5a3 May 06, 2026

1.14.5a3.dev20260508 May 08, 2026

1.14.5a3.dev20260507 May 07, 2026

1.14.5a2 May 04, 2026

1.14.5a2.dev20260505 May 05, 2026

1.14.5a1 May 01, 2026

1.14.5a1.dev20260504 May 04, 2026

1.14.5a1.dev20260503 May 03, 2026

1.14.5a1.dev20260502 May 02, 2026

1.14.5.dev20260520 May 20, 2026

1.14.5.dev20260519 May 19, 2026

1.14.4 Apr 30, 2026

1.14.4a1 Apr 29, 2026

1.14.4a1.dev20260430 Apr 30, 2026

1.14.4.dev20260501 May 01, 2026

1.14.3 Apr 24, 2026

1.14.3a3 Apr 22, 2026

1.14.3a3.dev20260424 Apr 24, 2026

1.14.3a3.dev20260423 Apr 23, 2026

1.14.3a2 Apr 21, 2026

1.14.3a2.dev20260422 Apr 22, 2026

1.14.3a1 Apr 20, 2026

1.14.3a1.dev20260421 Apr 21, 2026

1.14.3.dev20260429 Apr 29, 2026

1.14.3.dev20260428 Apr 28, 2026

1.14.3.dev20260425 Apr 25, 2026

1.14.2 Apr 17, 2026

1.14.2rc1 Apr 15, 2026

1.14.2rc1.dev20260417 Apr 17, 2026

1.14.2rc1.dev20260416 Apr 16, 2026

1.14.2a5 Apr 15, 2026

1.14.2a4 Apr 14, 2026

1.14.2a4.dev20260415 Apr 15, 2026

1.14.2a3 Apr 13, 2026

1.14.2a3.dev20260414 Apr 14, 2026

1.14.2a2 Apr 10, 2026

1.14.2a2.dev20260413 Apr 13, 2026

1.14.2a2.dev20260411 Apr 11, 2026

1.14.2a1 Apr 08, 2026

1.14.2a1.dev20260410 Apr 10, 2026

1.14.2a1.dev20260409 Apr 09, 2026

1.14.2.dev20260420 Apr 20, 2026

1.14.2.dev20260418 Apr 18, 2026

1.14.1 Apr 08, 2026

1.14.1rc1 Apr 08, 2026

1.14.0 Apr 07, 2026

1.14.0a4 Apr 07, 2026

1.14.0a3 Apr 06, 2026

1.14.0a3.dev20260407 Apr 07, 2026

1.14.0a2 Apr 06, 2026

1.14.0.dev20260408 Apr 08, 2026

1.13.0 Apr 02, 2026

1.13.0rc1 Mar 27, 2026

1.13.0rc1.dev20260331 Mar 31, 2026

1.13.0rc1.dev20260328 Mar 28, 2026

1.13.0rc1.dev20260327 Mar 27, 2026

1.13.0a7 Apr 02, 2026

1.13.0a6 Apr 01, 2026

1.13.0a6.dev20260402 Apr 02, 2026

1.13.0a5 Apr 01, 2026

1.13.0a4 Mar 31, 2026

1.13.0a4.dev20260401 Apr 01, 2026

1.13.0a3 Mar 31, 2026

1.13.0a2 Mar 26, 2026

1.13.0a1 Mar 26, 2026

1.13.0.dev20260406 Apr 06, 2026

1.13.0.dev20260404 Apr 04, 2026

1.13.0.dev20260403 Apr 03, 2026

1.12.2 Mar 26, 2026

1.12.1 Mar 26, 2026

1.12.1.dev20260326 Mar 26, 2026

1.12.0 Mar 26, 2026

1.12.0a3 Mar 25, 2026

1.12.0a2 Mar 25, 2026

1.12.0a1 Mar 25, 2026

1.11.1 Mar 23, 2026

1.11.1.dev20260325 Mar 25, 2026

1.11.1.dev20260324 Mar 24, 2026

1.11.0 Mar 18, 2026

1.11.0rc2 Mar 17, 2026

1.11.0rc2.dev20260318 Mar 18, 2026

1.11.0rc1 Mar 16, 2026

1.11.0rc1.dev20260317 Mar 17, 2026

1.11.0rc1.dev20260316 Mar 16, 2026

1.11.0.dev20260323 Mar 23, 2026

1.11.0.dev20260321 Mar 21, 2026

1.11.0.dev20260320 Mar 20, 2026

1.11.0.dev20260319 Mar 19, 2026

1.10.2rc2 Mar 14, 2026

1.10.2rc2.dev20260315 Mar 15, 2026

1.10.2rc2.dev20260314 Mar 14, 2026

1.10.2rc1 Mar 13, 2026

1.10.2a1 Mar 11, 2026

1.10.2a1.dev20260313 Mar 13, 2026

1.10.2a1.dev20260312 Mar 12, 2026

1.10.1 Mar 04, 2026

1.10.1a1 Feb 27, 2026

1.10.1.dev20260311 Mar 11, 2026

1.10.1.dev20260310 Mar 10, 2026

1.10.1.dev20260309 Mar 09, 2026

1.10.1.dev20260307 Mar 07, 2026

1.10.0 Feb 27, 2026

1.10.0a1 Feb 19, 2026

Wheel compatibility matrix

Platform	Python 3
any

Files in release

crewai_files-1.15.9-py3-none-any.whl (60.7KiB)

crewai_files-1.15.9.tar.gz (663.3KiB)

Extras: None

Dependencies:

python-magic (>=0.4.27)

tinytag (~=2.2.1)

crewai-files 1.15.9

crewai-files

Supported File Types

Usage

Passing Files to Crews

Passing Files to Tasks

Wheel compatibility matrix

Files in release