| --- |
| license: agpl-3.0 |
| language: |
| - cs |
| library_name: ultralytics |
| pipeline_tag: object-detection |
| tags: |
| - cropilot |
| - yolo |
| - document-layout-analysis |
| - document-cropping |
| - digitization |
| --- |
| |
| # Default Crop v1 |
|
|
| `default_crop_v1.pt` is a Cropilot model for detecting page crop regions in scanned printed documents. It is the general-purpose default crop model, trained on a mixed corpus of books, magazines, and newspapers. |
|
|
| It is published here as a reusable model artifact for use in the [Cropilot](https://github.com/moravianlibrary/cropilot) document-cropping ecosystem. |
|
|
| ## License |
|
|
| Released under the GNU Affero General Public License v3.0 (`AGPL-3.0`). |
|
|
| ## Model File |
|
|
| - File: `default_crop_v1.pt` |
| - Base model: YOLO11s |
| - Task: object-detection (page crop region) |
|
|
| ## Intended Use |
|
|
| This model is intended for semi-automated processing in a Cropilot workflow: |
|
|
| 1. Compressed JPEGs are created from original scans (e.g. TIFF). |
| 2. Cropilot runs AI detection using this model. |
| 3. A human operator reviews and corrects the result in the Cropilot editor. |
| 4. Final crops are applied to the original scans by the production tooling. |
|
|
| The model handles both **single-page** and **double-page (spread)** scans, making it a good general default when the document type is mixed or unknown. |
|
|
| ## Recommended Integration |
|
|
| Typical Cropilot settings for this model: |
|
|
| - Crop model: `default_crop` |
| - Rotation model: `text` |
|
|
| ## Training Data |
|
|
| The model was trained on a mixed corpus of digitized printed documents covering both single-page and double-page layouts. Approximate composition: |
|
|
| - ~80% books |
| - ~15% magazines / periodicals |
| - ~5% newspapers |
|
|
| The material spans roughly **1950–2010**. |
|
|
| ## Limitations |
|
|
| - Performance is strongest on recent books; older material, heavily illustrated layouts, or document types outside the training mix may need validation or further fine-tuning. |
| - Book covers are detected poorly. |
|
|
| ## Example Download |
|
|
| ```python |
| from huggingface_hub import hf_hub_download |
| |
| path = hf_hub_download( |
| repo_id="cropilot-community/default_crop_v1", |
| filename="default_crop_v1.pt", |
| ) |
| print(path) |
| ``` |
|
|
| ## Versioning |
|
|
| This repository stores **v1** of the default crop model. Newer fine-tuned models should be published as separate `v<n>` repositories so deployments remain reproducible. |
|
|
