README.md

---

library_name: onnxruntime
pipeline_tag: object-detection
license: agpl-3.0
base_model: juliozhao/DocLayout-YOLO-DocStructBench
tags:
  - yolo
  - doclayout-yolo
  - object-detection
  - document-layout-analysis
  - onnx
  - dynamic-axes
---


# DocLayout-YOLO — ONNX with dynamic axes

Re-export of [`juliozhao/DocLayout-YOLO-DocStructBench`](https://huggingface.co/juliozhao/DocLayout-YOLO-DocStructBench) and the DocLayNet-pretrained variant to **ONNX with dynamic batch + spatial dimensions**, which the upstream releases do not provide.

## Why dynamic axes?

The official DocLayout-YOLO ONNX exports use fixed input shapes (e.g. 1024×1024). Dynamic axes let downstream tools batch arbitrary page sizes without re-exporting per resolution — convenient for desktop OCR pipelines that hit pages of mixed DPI.

## Variants

| Subdir | Source | Use case |
|---|---|---|
| `doclayout_yolo_onnx_dynamic/` | DocStructBench (academic + business mix) | Primary — used by ScanIndex `layout_analyzer` |
| `doclayout_yolo_doclaynet_onnx_dynamic/` | DocLayNet (annotated diverse docs) | Auxiliary for non-table region routing |

Each subdir contains the `.onnx` + `.onnx.data` (external weights) + a `.names.json` for class id → label mapping.

## Loading

```python

import onnxruntime as ort

from huggingface_hub import snapshot_download

local = snapshot_download("welcomyou/doclayout-yolo-onnx-dynamic", local_dir="models")

sess = ort.InferenceSession(f"{local}/doclayout_yolo_onnx_dynamic/doclayout_yolo_docstructbench_imgsz1024_dynamic.onnx")

# input "images": (N, 3, H, W) where H, W must be multiples of 32

```

## Re-export reproduction

See [train-convert/doclayoutyolo/convert/export_doclayout_yolo_to_onnx.py](https://github.com/welcomyou/scanindex/blob/main/train-convert/doclayoutyolo/convert/export_doclayout_yolo_to_onnx.py).

## License

**AGPL-3.0**, inherited from upstream DocLayout-YOLO. Commercial use requires complying with AGPL terms or obtaining an alternative license from the authors.