docs: model card

README.md

@@ -0,0 +1,46 @@
+---
+library_name: lightgbm
+pipeline_tag: tabular-classification
+license: mit
+language:
+  - vi
+tags:
+  - lightgbm
+  - classification
+  - vietnamese
+  - document-segmentation
+  - page-splitting
+---
+
+# LightGBM page splitter — Vietnamese admin batches
+
+Two LightGBM Booster models used by [ScanIndex](https://github.com/welcomyou/scanindex) to split a multi-document scan batch into individual document boundaries:
+
+| Model | Task |
+|---|---|
+| `lightgbm_splitter/doc_start/model.txt` | Binary: is this page the **start** of a new document? |
+| `lightgbm_splitter/signer_page/model.txt` | Per-document: which page contains the signer block? |
+
+## Files
+
+- `lightgbm_splitter/doc_start/model.txt` — LightGBM Booster (text format, portable)
+- `lightgbm_splitter/doc_start/model.joblib` — sklearn wrapper (optional)
+- `lightgbm_splitter/signer_page/model.txt`
+- `lightgbm_splitter/signer_page/model.joblib`
+
+## Features
+
+Page-level features extracted from canonical OCR JSON: header/footer signals, regime presence, signer-block markers, page index, relative position, etc. See `build_doc_start_features` and the `predict_*` helpers in [scanindex/core/digitization/page_splitter.py](https://github.com/welcomyou/scanindex/blob/main/scanindex/core/digitization/page_splitter.py).
+
+## Loading
+
+```python
+import lightgbm as lgb
+from huggingface_hub import snapshot_download
+local = snapshot_download("welcomyou/lightgbm-vn-page-splitter", local_dir="models")
+booster = lgb.Booster(model_file=f"{local}/lightgbm_splitter/doc_start/model.txt")
+```
+
+## License
+
+MIT.