---
id: chunkr-ai
version: "0.3.7"
license: MIT License Copyright (c) 2025 Lumina AI INC Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal… (full text in the JSON record)
license_treatment: permissive
maintenance: aging
---

# chunkr-ai — Python client for Chunkr: open source document intelligence

License: permissive · Maintenance: aging · Downloads: 3.8M/mo

## What it is and what it does

Chunkr-ai is a Python client library for the Chunkr document intelligence API. It wraps HTTP calls to a remote Chunkr service (hosted or self-deployed) to upload documents and images, then retrieve processed results with configurable extraction strategies. The client handles both synchronous and asynchronous I/O, supports file paths, file objects, and PIL images as input, and allows fine-grained control over processing via Configuration objects (OCR strategy, segmentation approach, chunk sizing, JSON schema extraction, and result expiration).

The package is built on httpx, pydantic, and python-dotenv, making it lightweight and straightforward to integrate into existing Python workflows. It supports concurrent processing via asyncio or multiprocessing, and manages resource cleanup through context-aware close methods. The primary use case is extracting structured or semi-structured data from unstructured documents at scale, with the actual intelligence work delegated to the Chunkr backend.

Use it for:

- Batch extract text, tables, and metadata from a folder of PDFs using async concurrency.
- Build a document ingestion pipeline that converts images and scans into structured JSON matching a custom schema.
- Integrate document processing into a web service that accepts file uploads and returns parsed results.
- Automate OCR and layout analysis on high-resolution scans with configurable segmentation strategies.
- Process documents across multiple worker processes to parallelize I/O-bound uploads and polling.

## Worth the install?

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

A Python client for the Chunkr document intelligence API that uploads files and images for processing, supporting both synchronous and asynchronous workflows.

Yes, if you need to integrate Chunkr's document processing service into a Python application. The client is straightforward to use, supports both sync and async patterns, and has no known vulnerabilities. Install friction is low. However, you depend entirely on the Chunkr backend's availability and the package's aging maintenance status suggests reduced active development—verify that the service meets your reliability and support expectations before committing.

## Install

pip install chunkr-ai
uv add chunkr-ai
poetry add chunkr-ai

## Installing chunkr-ai

Before you install: Low friction install with five straightforward runtime dependencies. The package is aging (373 days since release) but continues to receive updates; maintenance status suggests it may not be actively developed.

License in practice: MIT License permits free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart:

pip install chunkr-ai

from chunkr_ai import Chunkr

chunkr = Chunkr()
task = chunkr.upload("document.pdf")
print(task.task_id)
chunkr.close()

Requires Python 3.10 or later. API key from Chunkr or self-hosted instance required; set via CHUNKR_API_KEY environment variable or direct initialization.

Verify before relying:

- Whether the Chunkr backend service is actively maintained and what its uptime/reliability guarantees are.
- Performance characteristics for concurrent processing at scale (throughput, latency, rate limits).
- Whether the package's aging status reflects stable maturity or reduced active development.

## Package facts

- License: MIT License Copyright (c) 2025 Lumina AI INC Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 3.8M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

document processing api client, pdf chunking and extraction, document intelligence python, async file upload client, ocr and segmentation api, document parsing service, structured data extraction, document-extraction, async-http-client, api-wrapper

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