skillfed

paddleocr

Awesome multilingual OCR and document parsing toolkits based on PaddlePaddle

paddleocr v3.7.0 3.2M downloads/30d#2,722 on PyPI87,658
Permissive license Apache License 2.0 Active released

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 paddleocr

uv

uv add paddleocr

poetry

poetry add paddleocr

Installing 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

Intended Audience :: DevelopersNatural Language :: Chinese (Simplified)Operating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Utilities

Tags

ocr text extractionpdf to markdown conversionmultilingual document parsingtable recognition from imagesdocument structure extractionvision language model ocrpdf document aistructured data from images
document-parsingmultilingualvision-language-model

More Utilities packages