Skip to content
ModelListedExternal
Browse files

Invoice Layout Yolov8s

Fine-tuned YOLOv8s for 8-class invoice document layout region detection (metadata, vendor/customer blocks, table, line items, summary, payment, column headers).

KindOtherBase modelultralytics/yolov8sVersionRevision 634c397Bgrade

Model source

Kind
Other
File size
21.5–85.4 MB
Base model
ultralytics/yolov8s
Version
vRevision 634c397
Updated
Sep 16, 2026
Downloads
18
Source
Hugging Face

Source description

Invoice Layout Detection — YOLOv8s

Fine-tuned YOLOv8s for 8-class invoice document layout region detection (metadata, vendor/customer blocks, table, line items, summary, payment, column headers).

Part of the Hub collection Invoice Layout Extraction.

PropertyValue
ArchitectureYOLOv8s (11.2M params, 28.6 GFLOPs)
Base weightsultralytics/yolov8s
Input size1024 px
Classes8 layout regions
Training epochs100 (best @ epoch 94)
OptimizerAdamW
DatasetAvoCahDoe/invoice-annotated-bbox
Demo SpaceAvoCahDoe/invoice-layout-yolov8n-demo
Train / val / test372 / 14 / 7 pages

Classes

IDName
0invoice_metadata
1vendor_block
2customer_block
3table_block
4line_item
5summary_block
6payment_block
7Column

Metrics

Test split (held-out, 7 images)

MetricValue
mAP500.9006
mAP50-950.6739
Precision0.9419
Recall0.8677

Validation (best epoch 94)

MetricBestFinal (epoch 100)
mAP500.85370.8478
mAP50-950.61400.6086
Precision0.85870.9096
Recall0.77950.7908

Training time: ~32.0 min on RTX 4070 Laptop GPU.

Training configuration

ParameterValue
Batch8
Image size1024
Patience25
LR (cosine)0.01 → 0.01
Mosaic1.0
Mixup0.15
Copy-paste0.1
Horizontal flip0.0

Training results

Learning curves

Training results

Precision–Recall

PR curve

Confusion matrices

RawNormalized
Confusion matrixNormalized confusion matrix

Validation predictions

Ground truthModel predictions
Val labelsVal predictions

Training batches (augmented)

Batch 0Batch 1Batch 2
Train batch 0Train batch 1Train batch 2

Label distribution

Label distribution

Usage

Ultralytics (recommended)

from ultralytics import YOLO
from huggingface_hub import hf_hub_download

weights = hf_hub_download("AvoCahDoe/invoice-layout-yolov8s", "weights/best.pt")
model = YOLO(weights)
results = model.predict("invoice_page.png", imgsz=1024, conf=0.25)
results[0].show()

Load from Hub by repo id

from ultralytics import YOLO

model = YOLO("hf://AvoCahDoe/invoice-layout-yolov8s/weights/best.pt")
results = model.predict("invoice_page.png")

Training reproduction

python scripts/train_comparison.py --models yolov8s

Repository layout

weights/best.pt          # Best checkpoint (use this)
weights/last.pt          # Last epoch checkpoint
config/                  # Training configuration
metrics/                 # Per-epoch and summary metrics
assets/                  # Plots and visualizations

Model comparison (test split)

All six architectures fine-tuned on the same invoice layout dataset.

RankModeltest mAP50test mAP50-95PrecisionRecallHub
1yolov8n0.96000.71670.95020.9592YOLOv8n
2yolov8s ← this model0.90060.67390.94190.8677YOLOv8s
3yolov8x0.87570.62240.91440.8735YOLOv8x
4yolo11x0.87380.61270.94840.8530YOLO11x
5yolo11m0.84180.49260.90330.8466YOLO11m
6yolov8m0.83880.52890.90770.8580YOLOv8m

License

Apache 2.0

Sources

1 source
Hugging FacePrimaryVersion 634c397e8bb7ce41a39200718d760d985ee4633d
huggingface.co/AvoCahDoe/invoice-layout-yolov8s/tree/634c397e8bb7ce41a39200718d760d985ee4633d

Verified Sep 1

Download files

Model artifacts

3 artifacts

best.pt

pt · 85.4 MB · SHA-256 e5dd527960e3…8eb2 · Hugging Face

Download file

weights/best.pt

pt · 21.5 MB · SHA-256 48758658919b…8178 · Hugging Face

Download file

weights/last.pt

pt · 21.5 MB · SHA-256 99ac0b705406…6427 · Hugging Face

Download file

Source excerpts

2 excerpts

--- license: apache-2.0 language: - en - de tags: - object-detection - yolo - yolov8 - ultralytics - invoice - document-layout - document-understanding - ocr-prep - invoice-extraction library_name: ultralytics pipeline_tag: object-detection base_model: ultralytics/yolov8s datasets: - AvoCahDoe/invoice-annotated-bbox metrics: - map_50 - map - precision - recall model-index: - name: best results: - task: type: object-detection dataset: name: invoice-yolo-annotated type: invoice-layout metrics: - type: map_50 value: 0.9006 - type: map value: 0.6739 - type: precision value: 0.9419 - type: recall value: 0.8677 --- # Invoice Layout Detection — YOLOv8s Fine-tuned **YOLOv8s** for **8-class invoice document layout** region detection (metadata, vendor/customer blocks, table, line items, summary, payment, column headers). Part of the Hub collection **[Invoice Layout Extraction](https://huggingface.co/collections/AvoCahDoe/invoice-layout-extraction-6a39cd2a061a508c8049d825)**. | Property | Value | |----------|-------| | **Architecture** | YOLOv8s (11.2M params, 28.6 GFLOPs) | | **Base weights** | `ultralytics/yolov8s` | | **Input size** | 1024 px | | **Classes** | 8 layout regions | | **Training epochs** | 100 (best @ epoch 94) | | **Optimizer** | AdamW | | **Dataset** | [AvoCahDoe/invoice-annotated-bbox](https://huggingface.co/datasets/AvoCahDoe/invoice-annotated-bbox) | | **Demo Space** | [AvoCahDoe/invoice-layout-yolov8n-demo](https://huggingface.co/spaces/AvoCahDoe/invoice-layout-yolov8n-demo) | | **Train / val / test** | 372 / 14 / 7 pages | ## Classes | ID | Name | |----|------| | 0 | `invoice_metadata` | | 1 | `vendor_block` | | 2 | `customer_block` | | 3 | `table_block` | | 4 | `line_item` | | 5 | `summary_block` | | 6 | `payment_block` | | 7 | `Column` | ## Metrics ### Test split (held-out, 7 images) | Metric | Value | |--------|-------| | **mAP50** | 0.9006 | | **mAP50-95** | 0.6739 | | **Precision** | 0.9419 | | **Recall** | 0.8677 | ### Validation (best epoch 94) | Metric | Best | Final (epoch 100) | |--------|------|-----------------------------------------------| | mAP50 | 0.8537 | 0.8478 | | mAP50-95 | 0.6140 | 0.6086 | | Precision | 0.8587 | 0.9096 | | Recall | 0.7795 | 0.7908 | Training time: ~32.0 min on RTX 4070 Laptop GPU. ## Training configuration | Parameter | Value | |-----------|-------| | Batch |...

Source context: 18 downloads · 0 likes · Pipeline object-detection · Library ultralytics · Repo AvoCahDoe/invoice-layout-yolov8s