PaddleOCR-VL

PaddleOCR-VL is PaddlePaddle's two-stage document parser. PP-DocLayoutV2 finds 25 kinds of layout region and their reading order, and PaddleOCR-VL-0.9B reads each region as text, a table, a formula or a chart. LibreYOLO ports the PaddleX pipeline around both networks for the ocr task.

작업
ocr
설치
pip install "libreyolo[vlm]"
지원 티어
별도 티어, v1.8.0부터 지원. 자체 팩토리와 계약을 갖춘 별도의 제품 영역입니다.
업스트림
PaddlePaddle Authors의 PaddleOCR-VL, Apache-2.0. 논문, 소스
라이선스
코드 Apache-2.0, 가중치 Apache-2.0. 상업적 사용

Install

PaddleOCR-VL belongs to LibreYOLO's VLM tier and needs the vlm extra. Both networks load through native transformers classes, which needs transformers 5.3 or newer. PaddlePaddle itself is not needed.

bash
pip install "libreyolo[vlm]"

Predict

Weights for both networks download on first use from one pinned mirror, LibreYOLO/LibrePaddleOCRVL0.9b. No remote code runs.

Python
from libreyolo import LibreVLM model = LibreVLM("paddleocr-vl")       # weights download on first useresult = model.predict("page.png")      # a scanned or rendered page for label, text in zip(result.ocr.labels, result.ocr.texts):    print(label, text[:60])             # one region per block, reading orderprint(result.ocr.markdown)              # the whole page as markdown
One element
from libreyolo import LibreVLM # Skip layout detection and read a pre-cropped formula.model = LibreVLM("paddleocr-vl", use_layout_detection=False, prompt_label="formula")result = model.predict("formula.png")print(result.ocr.texts[0])              # LaTeX
Charts
from libreyolo import LibreVLM # Charts are skipped by default, as upstream; opt in to read them as tables.model = LibreVLM("paddleocr-vl", use_chart_recognition=True)result = model.predict("report.png")

The family loads through LibreVLM(), or the LibrePaddleOCRVL class. Results.ocr holds one region per recognized block (a paragraph, a title, a table), not one per text line, in reading order: texts, polygons (axis-aligned boxes as 4-point quads), labels (the layout class) and the page in markdown. Tables come back as HTML and formulas as LaTeX. Pictures, and charts and seals by default, are left out of Results.ocr and the markdown.

Results.ocr.conf is the geometric mean of the generated tokens' probabilities and det_conf the layout score. conf= does not gate regions; the layout keeps the upstream per-class thresholds, which layout_threshold= overrides. Recognition is greedy with up to 4096 new tokens, and each region is resized within min_pixels / max_pixels (default 112896 / 1003520).

use_layout_detection=False with prompt_label= (ocr, table, formula or chart) reads a pre-cropped element.

Variants

One size, 0.9b: a NaViT-style vision encoder and the ERNIE-4.5-0.3B decoder, behind PP-DocLayoutV2. CUDA runs the recognizer in bf16 (fp16 without bf16 support) and the layout detector in fp32; CPU and MPS run both in fp32. On MPS, set PYTORCH_ENABLE_MPS_FALLBACK=1 if an operator is reported missing.

Not ported: adjacent text-block merging, figures embedded in tables, seal and spotting recognition, polygon layout shapes, document unwarping and image export. The markdown is the plain variant, with no HTML centering.

Validate

val() runs the shared OCR validator.

Python
from libreyolo import LibreVLM model = LibreVLM("paddleocr-vl")metrics = model.val(data="ocr_dataset/")   # det hmean, end-to-end F1, 1-NED

Export

Inference only: train() and export() raise.

Licensing

내려받는 특정 가중치의 Hugging Face 저장소에서 라이선스를 확인하십시오. LibreYOLO 조직의 모든 체크포인트에는 라이선스가 있으며 한 계열 안에서도 항상 같지는 않습니다. 해당 저장소가 신뢰할 수 있는 기준입니다. 아래 요약은 이 페이지를 마지막으로 검증했을 때 적용된 내용을 설명합니다.

관련 라이선스에 관한 설명이며 법률 자문이 아닙니다. 상업적으로 중요한 사안이라면 라이선스를 직접 읽고 별도의 법률 자문을 받으십시오.

원작
PaddleOCR-VL, PaddlePaddle Authors
업스트림 라이선스
Apache-2.0
LibreYOLO 코드
MIT
가중치
Apache-2.0, huggingface.co/LibreYOLO에 다시 게시됨
해석
Apache-2.0 is a permissive license, so the PaddleOCR-VL-0.9B recognizer and the PP-DocLayoutV2 layout detector can be used in commercial and closed-source products. Redistributing them means keeping the license text and attribution notices, and the license grants a patent license. Both networks run through the Apache-2.0 Hugging Face Transformers classes; LibreYOLO ports only the document-parsing pipeline (layout post-processing, prompt routing, markdown conversion) from PaddleX at commit 4c968d30b9d0d4a693d9eaaef0881c20f8d7d0e0, also Apache-2.0 (libreyolo/models/paddleocrvl/NOTICE), and the rest of the adapter is MIT. The weights are an unmodified, ungated mirror at LibreYOLO/LibrePaddleOCRVL0.9b of PaddlePaddle/PaddleOCR-VL (revision 7fa00a8c55b735ba51ba49a9058f3f9c57a99a11) with PaddlePaddle/PP-DocLayoutV2_safetensors (revision 880e8971b88938518611c54fc0f59ad57849c9d4) under layout/, shipping LICENSE and NOTICE. The recognizer's language model is initialized from Baidu's ERNIE-4.5-0.3B, also Apache-2.0.

PaddleOCR-VL-0.9B and PP-DocLayoutV2 are Apache-2.0, code and weights, by the PaddlePaddle Authors. Commercial use is allowed. The pipeline LibreYOLO ports from PaddleX is also Apache-2.0. The weights are an unmodified, ungated mirror.

Citation

@misc{cui2025paddleocrvlboostingmultilingualdocument,
      title={PaddleOCR-VL: Boosting Multilingual Document Parsing via a 0.9B Ultra-Compact Vision-Language Model}, 
      author={Cheng Cui and Ting Sun and Suyin Liang and Tingquan Gao and Zelun Zhang and Jiaxuan Liu and Xueqing Wang and Changda Zhou and Hongen Liu and Manhui Lin and Yue Zhang and Yubo Zhang and Handong Zheng and Jing Zhang and Jun Zhang and Yi Liu and Dianhai Yu and Yanjun Ma},
      year={2025},
      eprint={2510.14528},
      archivePrefix={arXiv},
      primaryClass={cs.CV},
      url={https://arxiv.org/abs/2510.14528}, 
}

huggingface.co/PaddlePaddle/PaddleOCR-VL#citation에 있는 저자의 인용 블록에서 복사했습니다.

LibreYOLO v1.8.0에서 검증되었습니다. 이 페이지의 지원 표, 체크포인트, 벤치마크 수치는 출시된 라이브러리와 공개된 가중치에서 생성되며 수동으로 작성되지 않습니다.