Duplicate from MiguelEscamilla/id-card-yolo

Co-authored-by: MIguel Escamilla <MiguelEscamilla@users.noreply.huggingface.co>

.gitattributes

@@ -0,0 +1,35 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text

README.md

@@ -0,0 +1,98 @@
+---
+license: other
+tags:
+- object-detection
+- computer-vision
+- yolo
+- id-card
+- document-ai
+- pytorch
+- onnx
+library_name: ultralytics
+pipeline_tag: object-detection
+---
+
+# ID Card Object Detection Model (YOLO)
+
+## 📌 Overview
+
+This model is a YOLO-based object detection model trained to detect regions on ID card images such as:
+
+- ID card boundaries
+- Face / portrait region
+- Barcodes / QR codes
+- Text regions / structured fields (depending on dataset)
+
+The model is intended for:
+- Document processing pipelines
+- OCR preprocessing and region extraction
+- Identity verification workflows
+- Computer vision research and prototyping
+
+The model outputs bounding boxes, class labels, and confidence scores.
+
+---
+
+## 🚀 How to Use
+
+### Python (Ultralytics)
+
+```python
+from ultralytics import YOLO
+
+model = YOLO('best.pt')
+results = model.predict('image.jpg', conf=0.25)
+results[0].show()
+```
+
+### Download from Hugging Face
+
+```python
+from huggingface_hub import hf_hub_download
+
+model_path = hf_hub_download(repo_id='miguelescamilla/id-card-yolo', filename='best.pt')
+```
+
+---
+
+## 🧠 Model Details
+
+- Architecture: YOLO (Ultralytics)
+- Framework: PyTorch
+- Input size: 640×640 (default)
+- Task: Object Detection
+- Outputs:
+  - Bounding boxes (xyxy)
+  - Class IDs
+  - Confidence scores
+
+---
+
+## ⚠️ Limitations
+
+- Performance depends on image quality, lighting, and camera perspective.
+- Accuracy is limited by the size and diversity of the training dataset.
+- Not validated for safety-critical or regulated environments.
+
+---
+
+## 📜 License & Credits
+
+### Model Weights
+This repository contains trained model weights uploaded by the author.
+
+### YOLO Framework Credit
+This model was trained using **Ultralytics YOLO**, licensed under the **AGPL-3.0 license**.
+
+**Important:** If you use this model in commercial or proprietary systems, you must comply with Ultralytics licensing terms or obtain a commercial license.
+
+Ultralytics Links:
+- https://github.com/ultralytics/ultralytics
+- https://www.ultralytics.com
+
+---
+
+## 👤 Author
+
+Uploaded by: miguelescamilla
+Last updated: 2026-01-12

best.pt

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:03242ba44d7a495e54bbdb56517eec74cbf2123e00185cf17027f2a5ab8bf204
+size 6249258