chunkr-ai

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

chunkr-ai on PyPI

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

Evidence: chunkr_ai-0.3.7-py3-none-any.whl

Tags

More Text Processing packages