docs: model card

README.md

@@ -0,0 +1,48 @@
+---
+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.