Repository navigation
DocLayout 3.1.0 completes the pinned PP-DocLayoutV3 ONNX decode and carries its usable geometry and reading order through conversion. Sol still reads the whole page and supplies text and HTML.
Highlights
- Retains V3 masks, classes, scores, boxes, and raw order keys; derives page-pixel contours and draws them in annotated images/PDFs. Invalid contours fall back to V3 rectangles, and unavailable or unmatched V3 geometry falls back to Sol without losing content.
- Uses a compact region guide and deterministic one-to-one reconciliation, with source-footprint lineage and explicit matching/fallback diagnostics. V3-only detections remain diagnostic evidence.
- Keeps automatic CUDA detection with CPU retry and visible whole-page Sol fallback on V3 runtime failure.
- Adds GUI authorization-field extraction from saved raw Markdown, local JSON/SQLite results, and optional classification that remains off by default.
Compatibility
- The pinned official
PaddlePaddle/PP-DocLayoutV3_onnxartifact remains unchanged. Direct ONNX Runtime and its dependencies are now part of the base package; the former optionallayoutextra is not needed. First use may download the hash-verified weights. - New conversions use pipeline
sol-layout-v3/v4; accepted V3 matches can change geometry and reading order. Saved conversions retain their historical provenance, and field-only retries do not reconvert PDFs. - Python >=3.11 is required. PyPI publication remains deferred.
Verification and limits
- 443 offline tests passed, 1 skipped; Ruff F,E9, uv lock, and dependency checks passed.
- Wheel and source archive built. An isolated Windows Python 3.13 wheel install passed CLI, packaged resource, GUI/API import, dependency, and uv-tool smoke checks.
- These checks do not establish model accuracy or fresh-machine GPU behavior. See the dated verification record in docs/layout-v3-plan.md for live-validation limits.
Install the base wheel with uv:
uv pip install "https://github.com/pypi-ahmad/DocLayout/releases/download/v3.1.0/doclayout-3.1.0-py3-none-any.whl"