paddleocr
Awesome multilingual OCR and document parsing toolkits based on PaddlePaddle
What it is and what it does
PaddleOCR is a multilingual optical character recognition and document parsing toolkit that converts images and PDFs into structured, machine-readable formats (JSON or Markdown). It combines traditional scene text recognition with specialized vision-language models for document understanding, supporting over 100 languages through unified models that eliminate the need for language switching. The package includes multiple model tiers (tiny, small, medium) optimized for different deployment scenarios—from edge devices to cloud servers—and handles complex document elements like tables, formulas, and charts alongside plain text.
The toolkit is designed for building RAG and agentic AI applications, with integration points for popular frameworks. Runtime dependencies are minimal: PyYAML, requests, aiohttp, typing-extensions, and paddlex, keeping the installation footprint light despite the capability breadth.
Use it for:
- Extract text and tables from scanned documents or PDFs for data entry automation or archival systems.
- Convert business documents (invoices, receipts, forms) into structured JSON for downstream processing or database ingestion.
- Build document-aware RAG pipelines by parsing PDFs into Markdown and feeding them to LLM retrieval systems.
- Recognize text in natural scene images (street signs, license plates, industrial labels) for computer vision applications.
- Parse multilingual documents without model switching, handling mixed-language content in a single pass.
- Deploy lightweight OCR on edge devices or mobile environments using the tiny model tier.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
PaddleOCR extracts text, tables, and structured data from images and PDFs, converting them into JSON or Markdown format with support for over 100 languages and specialized document parsing models.
Yes. PaddleOCR is actively maintained, permissively licensed, has low install friction, and zero known vulnerabilities. It addresses a well-defined problem (document parsing and multilingual OCR) with broad ecosystem integration. Install it if you need OCR or document-to-structured-data conversion; the main gotcha is that models download on first use.
Install
paddleocr on PyPI
pip
pip install paddleocruv
uv add paddleocrpoetry
poetry add paddleocrInstalling paddleocr
Before you install
Low friction installation with a pure Python wheel. Active maintenance with recent releases and strong community signal. Supports Python 3.8–3.13.
License in practice
Apache License 2.0 is permissive, allowing commercial and private use with minimal restrictions—suitable for most production deployments.
Quickstart
pip install paddleocr
from paddleocr import PaddleOCR
ocr = PaddleOCR(use_angle_cls=True, lang='en')
result = ocr.ocr('image.jpg', cls=True)
Models are downloaded on first use; initial run may require network access and disk space for model files.
Verify before relying
- Exact model download size and disk space requirements for different model tiers (tiny, small, medium).
- Performance benchmarks on specific hardware (GPU models, CPU types) beyond the general speedup claims.
- Whether all 100+ languages are equally accurate or if accuracy varies significantly by language.
- Real-world latency and throughput on production-scale document batches.
Package facts
| License | Apache License 2.0 (permissive) |
| Python support | supports the current Python release (>=3.8) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 5 — paddlex, PyYAML, requests, aiohttp, typing-extensions |
| Maintenance | actively maintained — 64 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 3,152,944/month — #2,722 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: paddleocr-3.7.0-py3-none-any.whl
Keywords: ocr, textdetection, textrecognition, paddleocr, chineseocr, pp-ocr, pp-structure, document-parsing, pdf2markdown, doc2markdown, docx2markdown, kie, pp-chatocr, document-translation, rag
Tags
More Utilities packages
Converts domain names between Unicode and…
permissive · top 100 on PyPI
charset-normalizerDetects and normalizes text encoding from…
permissive · top 100 on PyPI
setuptoolsSetuptools is a Python build backend and…
permissive · top 100 on PyPI
pluggyPluggy provides a plugin system that lets you…
permissive · top 100 on PyPI
PygmentsPygments is a syntax highlighter that colorizes…
permissive · top 100 on PyPI
sixSix provides utility functions to write Python…
permissive · top 100 on PyPI
mineruConverts PDF, DOCX, PPTX, XLSX, images, and web…
unclear · top 15,000 on PyPI
paddlexPaddleX is a low-code framework for training,…
permissive · top 5,000 on PyPI
surya-ocrSurya is an OCR and document intelligence model…
permissive · top 5,000 on PyPI
rapidocrRapidOCR extracts text from images using…
permissive · top 5,000 on PyPI
marker-pdfMarker converts PDFs, images, and other…
permissive · top 15,000 on PyPI
cnocrCnOCR recognizes text in images—Chinese…
permissive · top 15,000 on PyPI
rapidocr-onnxruntimePerforms optical character recognition (OCR) on…
permissive · top 5,000 on PyPI
unstructured-inferenceRuns inference on layout-parsing and…
permissive · top 5,000 on PyPI
img2tableIdentifies and extracts tables from images and…
permissive · top 15,000 on PyPI
kreuzbergExtracts text, tables, images, and metadata…
permissive · top 15,000 on PyPI