PP-DocLayoutV3

PP-DocLayoutV3 is PaddleOCR's document layout detector. It finds the regions of a page (text, titles, tables, figures, formulas, headers, footers, seals and more) and ranks them in reading order. LibreYOLO ports it as a detect family that needs no transformers or PaddlePaddle runtime.

Tác vụ
detection
Kích thước
l at 800 px
Cài đặt
pip install libreyolo
Bậc hỗ trợ
Chỉ suy luận, từ v1.8.0. Chỉ dự đoán, kiểm định và xuất. Không áp dụng các tính năng huấn luyện.
Thượng nguồn
PP-DocLayoutV3 của PaddlePaddle Authors, Apache-2.0. Bài báo, mã nguồn
Giấy phép
Mã nguồn Apache-2.0, trọng số Apache-2.0. Sử dụng thương mại

Install

PP-DocLayoutV3 needs no optional extra. It is pure PyTorch and everything it imports is in the base install.

bash
pip install libreyolo

Predict

Weights download from LibreYOLO/LibrePPDocLayoutV3l on first use.

Python
from libreyolo import LibreYOLO model = LibreYOLO("LibrePPDocLayoutV3l.pt")result = model("page.png", conf=0.5)    # the upstream pipeline's threshold for order, box, cls, score in zip(    result.reading_order, result.boxes.xyxy, result.boxes.cls, result.boxes.conf):    print(int(order), result.names[int(cls)], round(float(score), 3), box.tolist())
CLI
libreyolo predict model=LibrePPDocLayoutV3l.pt source=page.png conf=0.5 save=True
Official weights
from libreyolo import LibreYOLO # Upstream's model.safetensors loads too: it is converted once and a# LibreYOLO checkpoint is written beside it.model = LibreYOLO("model.safetensors")

Results.boxes holds xyxy boxes on the original page, confidences and class ids over 25 layout classes. Rows are sorted in reading order, and Results.reading_order is a one-based int64 vector aligned with the boxes. It slices with results[i] like track_id and appears as reading_order in Results.summary() rows. Ranks are computed among the regions kept at conf; a classes= filter or a max_det cut keeps the surviving ranks, so the values can have gaps.

The upstream pipeline uses conf=0.5; LibreYOLO's default conf=0.25 keeps more low-confidence regions. As upstream, scores are per-class sigmoids and the top 300 (query, class) pairs are kept, so one region can be reported with two labels. No NMS is applied.

Classes: abstract, algorithm, aside_text, chart, content, display_formula, doc_title, figure_title, footer, footer_image, footnote, formula_number, header, header_image, image, inline_formula, number, paragraph_title, reference, reference_content, seal, table, text, vertical_text, vision_footnote.

The same port runs the layout stage of Falcon OCR with layout=True.

Variants

One size, l: an RT-DETR-style set-prediction detector with an HGNetV2-L backbone, mask-enhanced query initialisation and a global-pointer head that scores every pair of regions. Input is a fixed 800x800 canvas (stretch resize, RGB in [0, 1], no normalization). It runs on CPU, CUDA and MPS; on MPS the positional encoding is computed in float32, so results can differ in the last bits.

Against the Apache-2.0 PyTorch reference in transformers, on CUDA in fp32 with the same input tensor, logits, boxes, reading-order logits and masks match exactly on three real pages and a random tensor. Training is not offered: it needs reading-order and per-region mask supervision that LibreYOLO's detect datasets do not carry. The per-region polygons upstream derives from the mask branch are not exposed.

Export

Tác vụONNXTorchScriptExecuTorchTensorRTOpenVINOPaddleMNNRKNNAxelerancnnTFLiteCoreMLCore AI
DetectionDetection to ONNX: được hỗ trợDetection to TorchScript: được hỗ trợDetection to ExecuTorch: được hỗ trợDetection to TensorRT: được hỗ trợDetection to OpenVINO: được hỗ trợDetection to Paddle: không được hỗ trợDetection to MNN: không được hỗ trợDetection to RKNN: không được hỗ trợDetection to Axelera: không được hỗ trợDetection to ncnn: không được hỗ trợDetection to TFLite: không được hỗ trợDetection to CoreML: không được hỗ trợDetection to Core AI: không được hỗ trợ

ONNX (opset 17) and TorchScript, fixed 800x800, FP32. The graph outputs pred_logits, pred_boxes and order_votes; exported backends return the same Results, including reading_order.

Python
from libreyolo import LibreYOLO model = LibreYOLO("LibrePPDocLayoutV3l.pt")model.export(format="onnx")             # fixed 800x800, FP32model.export(format="torchscript")
CLI
libreyolo export model=LibrePPDocLayoutV3l.pt format=onnx
Use the exported file
from libreyolo import LibreYOLO model = LibreYOLO("LibrePPDocLayoutV3l.onnx")result = model("page.png", conf=0.5)print(result.reading_order)

Checkpoints

TệpĐầu vào (px)Giấy phép trọng số
Detection
LibrePPDocLayoutV3l.pt800apache-2.0

Mọi tệp ở trên hiện đều có trong tổ chức LibreYOLO và được tải xuống trong lần sử dụng đầu tiên.

Licensing

Hãy kiểm tra giấy phép trong repo Hugging Face của trọng số cụ thể mà bạn tải xuống. Mỗi checkpoint trong tổ chức LibreYOLO đều có giấy phép riêng và giấy phép có thể khác nhau trong cùng một họ. Repo đó là nguồn có thẩm quyền; phần tóm tắt dưới đây mô tả các điều khoản áp dụng khi trang này được kiểm chứng lần gần nhất.

Đây là phần mô tả các giấy phép liên quan, không phải tư vấn pháp lý. Nếu câu trả lời có ý nghĩa về mặt thương mại, hãy tự đọc các giấy phép và tham khảo cố vấn của riêng bạn.

Công trình gốc
PP-DocLayoutV3, PaddlePaddle Authors
Giấy phép thượng nguồn
Apache-2.0
Nguồn thượng nguồn
github.com/PaddlePaddle/PaddleOCR
Mã nguồn LibreYOLO
MIT
Trọng số
Apache-2.0, được phát hành lại tại huggingface.co/LibreYOLO
Diễn giải
Apache-2.0 is a permissive license, so the PP-DocLayoutV3 weights and LibreYOLO's port 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. LibreYOLO's network is an inference-only PyTorch port of the Apache-2.0 reference in Hugging Face Transformers (v5.22.1, commit 446a570e62b04a89ea001604ada7366baac2ea67, Copyright The PaddlePaddle Team and The HuggingFace Inc. team) and needs no transformers runtime (libreyolo/models/ppdoclayoutv3/NOTICE). The checkpoint is converted from PaddlePaddle/PP-DocLayoutV3_safetensors at revision e4f489dc536556fc1be02b973ba06756e0d4a2ac, declared Apache-2.0 by its model card; that repository ships no LICENSE file, so the mirror at LibreYOLO/LibrePPDocLayoutV3l carries the Apache-2.0 text of the PaddleOCR project. Conversion only strips a key prefix and adds metadata; learned parameters are unchanged, and the mirror is not gated.

PP-DocLayoutV3 is Apache-2.0, code and weights, by the PaddlePaddle Authors. Commercial use is allowed. The checkpoint is converted from PaddlePaddle/PP-DocLayoutV3_safetensors by stripping a key prefix and adding metadata; learned parameters are unchanged and the mirror is not gated.

Citation

@misc{cui2026rtdoclayoutrealtimeendtoenddocument,
      title={RT-DocLayout: Real-Time End-to-End Document Layout Analysis with Reading Order in the Wild}, 
      author={Cheng Cui and Tingquan Gao and Xueqing Wang and Changda Zhou and Hongen Liu and Ting Sun and Yubo Zhang and Zelun Zhang and Jiaxuan Liu and Manhui Lin and Yue Zhang and Suyin Liang and Yiqing Xiang and Yi Liu},
      year={2026},
      eprint={2606.23344},
      archivePrefix={arXiv},
      primaryClass={cs.CV},
      url={https://arxiv.org/abs/2606.23344}, 
}

Được sao chép từ khối trích dẫn của tác giả tại huggingface.co/PaddlePaddle/PP-DocLayoutV3_safetensors#citation.

Đã kiểm chứng với LibreYOLO v1.8.0. Các bảng hỗ trợ, checkpoint và số liệu benchmark trên trang này được tạo từ thư viện đã phát hành và trọng số đã công bố, không phải viết thủ công.