PaddleOCR README

The project's README from github.com/PaddlePaddle/PaddleOCR. As one markdown file: README.md.

Star-history

Global Leading OCR Toolkit & Document AI Engine

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Français | Русский | Español | العربية

PyPI Downloads Used by python os hardware

AI Studio Ask DeepWiki License

PaddleOCR converts PDF documents and images into structured, LLM-ready data (JSON/Markdown) with industry-leading accuracy. With 70k+ Stars and trusted by top-tier projects like Dify, RAGFlow, and Cherry Studio, PaddleOCR is the bedrock for building intelligent RAG and Agentic applications.

🚀 Key Features

📄 Intelligent Document Parsing (LLM-Ready)

Transforming messy visuals into structured data for the LLM era.

🔍 Universal Text Recognition (Scene OCR)

The global gold standard for high-speed, multilingual text spotting.

PaddleOCR Architecture

🛠️ Developer-Centric Ecosystem

📣 Recent updates

🔥 2026.07.22: HPD-Parsing is now available

2026.06.11: Release of PaddleOCR 3.7.0
  • PP-OCRv6 highlights:

    • Accuracy boost: Medium tier achieves +4.6% detection and +5.1% recognition over PP-OCRv5_server, surpassing mainstream VLMs (Qwen3-VL-235B, GPT-5.5) with only 34.5M parameters.
    • 50 languages unified: Single model covers Chinese, English, Japanese, and 46 Latin-script languages — no model switching needed.
    • Specialized scenarios: Major improvements in digital displays, dot-matrix characters, tire prints, and industrial text recognition.
    • Faster inference: 5.2× CPU speedup (OpenVINO), 6.1× on Apple M4 (tiny), 0.13s on A100 GPU.
    • Three tiers for all scenarios: tiny (1.5M) / small (7.7M) / medium (34.5M) for edge, mobile, and server deployment.
    • Model availability: All models are available on HuggingFace and ModelScope.
2026.05.28: Release of PaddleOCR 3.6.0
  • PaddleOCR-VL-1.6 highlights:

    • New SOTA Accuracy: Achieves over 96.3% on OmniDocBench v1.6, also sets new SOTA on OmniDocBench v1.5 and Real5-OmniDocBench, leading both open-source and proprietary solutions in text, formula, and table recognition.
    • Comprehensive Capability Upgrade: Significant improvements in table, ancient document, and rare character recognition, with notably enhanced seal recognition, spotting, and chart understanding across multiple scenarios.
    • Seamless Migration: Model architecture is fully consistent with PaddleOCR-VL-1.5, enabling zero-cost adaptation—swap and go.
    • Try it now: Available on HuggingFace or our Official Website.
2026.04.21: Release of PaddleOCR 3.5.0
  • Flexible inference backends: Seamlessly switch between Paddle static graph, Paddle dynamic graph, or Transformers. PaddleOCR is now deeply integrated with the Hugging Face ecosystem, and 20 major models support Transformers as the inference backend.
  • Office documents to Markdown: Convert common document formats such as Word, Excel, and PowerPoint into Markdown.
  • DOCX export for parsed results: The PaddleOCR-VL series, PP-StructureV3, and PP-DocTranslation now support exporting parsed results to DOCX for convenient viewing and editing in Microsoft Word.
  • Official browser inference SDK: Released PaddleOCR.js, the official browser inference SDK that supports running PP-OCRv5 directly in the browser.
2026.01.29: Release of PaddleOCR 3.4.0
  • PaddleOCR-VL-1.5 (SOTA 0.9B VLM): Our latest flagship model for document parsing is now live!
    • 94.5% Accuracy on OmniDocBench: Surpassing top-tier general large models and specialized document parsers.
    • Real-World Robustness: First to introduce the PP-DocLayoutV3 algorithm for irregular shape positioning, mastering 5 tough scenarios: Skew, Warping, Scanning, Illumination, and Screen Photography.
    • Capability Expansion: Now supports Seal Recognition, Text Spotting, and expands to 111 languages (including China’s Tibetan script and Bengali).
    • Long Document Mastery: Supports automatic cross-page table merging and hierarchical heading identification.
    • Try it now: Available on HuggingFace or our Official Website.
2025.10.16: Release of PaddleOCR 3.3.0
  • Released PaddleOCR-VL:

    • Model Introduction:

      • PaddleOCR-VL is a SOTA and resource-efficient model tailored for document parsing. Its core component is PaddleOCR-VL-0.9B, a compact yet powerful vision-language model (VLM) that integrates a NaViT-style dynamic resolution visual encoder with the ERNIE-4.5-0.3B language model to enable accurate element recognition. This innovative model efficiently supports 109 languages and excels in recognizing complex elements (e.g., text, tables, formulas, and charts), while maintaining minimal resource consumption. Through comprehensive evaluations on widely used public benchmarks and in-house benchmarks, PaddleOCR-VL achieves SOTA performance in both page-level document parsing and element-level recognition. It significantly outperforms existing solutions, exhibits strong competitiveness against top-tier VLMs, and delivers fast inference speeds. These strengths make it highly suitable for practical deployment in real-world scenarios. The model has been released on HuggingFace. Everyone is welcome to download and use it! More introduction information can be found in PaddleOCR-VL.
    • Core Features:

      • Compact yet Powerful VLM Architecture: We present a novel vision-language model that is specifically designed for resource-efficient inference, achieving outstanding performance in element recognition. By integrating a NaViT-style dynamic high-resolution visual encoder with the lightweight ERNIE-4.5-0.3B language model, we significantly enhance the model’s recognition capabilities and decoding efficiency. This integration maintains high accuracy while reducing computational demands, making it well-suited for efficient and practical document processing applications.
      • SOTA Performance on Document Parsing: PaddleOCR-VL achieves state-of-the-art performance in both page-level document parsing and element-level recognition. It significantly outperforms existing pipeline-based solutions and exhibiting strong competitiveness against leading vision-language models (VLMs) in document parsing. Moreover, it excels in recognizing complex document elements, such as text, tables, formulas, and charts, making it suitable for a wide range of challenging content types, including handwritten text and historical documents. This makes it highly versatile and suitable for a wide range of document types and scenarios.
      • Multilingual Support: PaddleOCR-VL Supports 109 languages, covering major global languages, including but not limited to Chinese, English, Japanese, Latin, and Korean, as well as languages with different scripts and structures, such as Russian (Cyrillic script), Arabic, Hindi (Devanagari script), and Thai. This broad language coverage substantially enhances the applicability of our system to multilingual and globalized document processing scenarios.
  • Released PP-OCRv5 Multilingual Recognition Model:

    • Improved the accuracy and coverage of Latin script recognition; added support for Cyrillic, Arabic, Devanagari, Telugu, Tamil, and other language systems, covering recognition of 109 languages. The model has only 2M parameters, and the accuracy of some models has increased by over 40% compared to the previous generation.
2025.08.21: Release of PaddleOCR 3.2.0
  • Significant Model Additions:

    • Introduced training, inference, and deployment for PP-OCRv5 recognition models in English, Thai, and Greek. The PP-OCRv5 English model delivers an 11% improvement in English scenarios compared to the main PP-OCRv5 model, with the Thai and Greek recognition models achieving accuracies of 82.68% and 89.28%, respectively.
  • Deployment Capability Upgrades:

    • Full support for PaddlePaddle framework versions 3.1.0 and 3.1.1.
    • Comprehensive upgrade of the PP-OCRv5 C++ local deployment solution, now supporting both Linux and Windows, with feature parity and identical accuracy to the Python implementation.
    • High-performance inference now supports CUDA 12, and inference can be performed using either the Paddle Inference or ONNX Runtime backends.
    • The high-stability service-oriented deployment solution is now fully open-sourced, allowing users to customize Docker images and SDKs as required.
    • The high-stability service-oriented deployment solution also supports invocation via manually constructed HTTP requests, enabling client-side code development in any programming language.
  • Benchmark Support:

    • All production lines now support fine-grained benchmarking, enabling measurement of end-to-end inference time as well as per-layer and per-module latency data to assist with performance analysis. Here's how to set up and use the benchmark feature.
    • Documentation has been updated to include key metrics for commonly used configurations on mainstream hardware, such as inference latency and memory usage, providing deployment references for users.
  • Bug Fixes:

    • Resolved the issue of failed log saving during model training.
    • Upgraded the data augmentation component for formula models for compatibility with newer versions of the albumentations dependency, and fixed deadlock warnings when using the tokenizers package in multi-process scenarios.
    • Fixed inconsistencies in switch behaviors (e.g., use_chart_parsing) in the PP-StructureV3 configuration files compared to other pipelines.
  • Other Enhancements:

    • Separated core and optional dependencies. Only minimal core dependencies are required for basic text recognition; additional dependencies for document parsing and information extraction can be installed as needed.
    • Enabled support for NVIDIA RTX 50 series graphics cards on Windows; users can refer to the installation guide for the corresponding PaddlePaddle framework versions.
    • PP-OCR series models now support returning single-character coordinates.
    • Added AIStudio, ModelScope, and other model download sources, allowing users to specify the source for model downloads.
    • Added support for chart-to-table conversion via the PP-Chart2Table module.
    • Optimized documentation descriptions to improve usability.

History Log

🚀 Quick Start

Step 1: Try Online

PaddleOCR official website provides interactive Experience Center and APIs—no setup required, just one click to experience.

👉 Visit Official Website

Step 2: Local Deployment

For local usage, please refer to the following documentation based on your needs:

🧩 More Features

🔄 Quick Overview of Execution Results

PP-OCRv5

PaddleOCR (PaddlePaddle/PaddleOCR)

vlm
Searching Database…

91.3K ·GitHub
What is this?PaddleOCR is an OCR and document AI toolkit that converts PDFs and images into structured, LLM-ready data (JSON or Markdown), supporting over 100 languages.
Is this a standalone app or a library I integrate into my own pipeline?It's a Python toolkit/library with multiple production pipelines (PP-OCR, PP-StructureV3, PaddleOCR-VL) that you call from code, plus service deployment options and a browser SDK (PaddleOCR.js).
How do I get it running?Install the core package via pip for basic text recognition, and add optional dependencies for document parsing or information extraction features as needed.
Is high accuracy only for Chinese/English, or does it hold up across other languages too?PP-OCRv6 unifies 50 languages in a single model including Chinese, English, Japanese and 46 Latin-script languages, and the PaddleOCR-VL line separately covers 100+ languages including Tibetan and Bengali, but language coverage differs between the lightweight OCR models and the VLM-based parsing models.
What is PaddleOCR-VL?PaddleOCR-VL is a compact 0.9B-parameter vision-language model built on a NaViT-style visual encoder plus the ERNIE-4.5-0.3B language model, designed for state-of-the-art document parsing (text, tables, formulas, charts) with minimal compute.
Can it convert Word, Excel or PowerPoint files too, not just PDFs?Yes, since the 3.5.0 release PaddleOCR can convert Office documents like Word, Excel, and PowerPoint into Markdown, and parsed results can also be exported to DOCX.
What tools does PaddleOCR integrate with?It's deeply integrated with AI agent and RAG ecosystem tools like Dify, RAGFlow, Pathway, and Cherry Studio, serving as a data pipeline for building LLM-ready datasets.
How fast is the latest OCR model compared to the previous version?PP-OCRv6 improves detection accuracy by 4.6% and recognition by 5.1% over PP-OCRv5 while running 5.2x faster on CPU, and it outperforms larger mainstream vision-language models despite having only 34.5M parameters.
Size
1.9 GB
Stars
91.3K
Age
6y
Commits · 90 Days