OcrDoc — Fine-tuned PP-OCRv6 for Vietnamese Identity Documents & Passports

Bộ trọng số ONNX chính thức được fine-tune chuyên biệt cho xử lý OCR Giấy tờ Tuỳ thân Việt Nam (Căn cước công dân / CMND) và Hộ chiếu quốc tế (ICAO 9303 TD1 / TD3), thuộc dự án mã nguồn mở e4glevlr/ocr-doc.

Tối ưu hóa để chạy 100% offline trên CPU, không cần GPU, siêu nhẹ và bảo mật dữ liệu tuyệt đối.

📦 Danh mục Tệp trong Repo

Lưu ý: Các bản fine-tune của PP-OCRv6 medium rec đều có cùng kích thước file (62.289.039 byte). Vui lòng đối chiếu SHA256 hoặc kiểm tra tên file để phân biệt chính xác.

📊 Kết quả Benchmark & Đánh đổi

PP-OCRv5/v6 nguyên bản (stock) đạt 0% exact match trên chữ tiếng Việt có dấu. Bộ model fine-tune này khắc phục triệt để vấn đề:

Lựa chọn giữa Run 6 và Run 5b:

• Run 6 (Mặc định): Giải quyết triệt để địa chỉ cột hẹp và nhãn dính liền trên CCCD 2021 (tăng từ 45.8% lên 60.4%, ngang ngửa VietOCR nhưng tốc độ nhanh hơn nhiều).
• Run 5b (Dự phòng): Nếu hệ thống của bạn ưu tiên độ chính xác tuyệt đối ở trường Họ tên trên CCCD 2021 hơn trường Địa chỉ, chỉ cần đổi sang dùng vi_v6_medium_rec_run5b.onnx.

🚀 Hướng dẫn Sử dụng

1. Dùng trực tiếp với OcrDoc CLI (.NET / C#)

Tải bản bundle hoặc tự build theo hướng dẫn tại e4glevlr/ocr-doc:

# Tải models từ Hugging Face
huggingface-cli download truonggiabao7/ocrdoc-models --local-dir models/

# Chạy OCR đối soát 2 mặt CCCD
ocrdoc-cli read --models models/ mat_truoc.jpg mat_sau.jpg

# Xuất định dạng JSON
ocrdoc-cli read --models models/ --json mat_truoc.jpg mat_sau.jpg > ket_qua.json

2. Tích hợp trong dự án C# (.NET 8)

using OcrDoc;

using var ocr = new DocumentOcr(new OcrOptions
{
    DetectionModelPath   = "models/detection.onnx",
    RecognitionModelPath = "models/recognition.onnx", // hoặc vi_v6_medium_rec_run5b.onnx
    DictionaryPath       = "models/charset.txt",
    NumThreads           = 0, // Dùng toàn bộ core CPU
    AutoOrient           = false
});

var result = ocr.ReadFiles("front.jpg", "back.jpg");
if (result.Type == DocumentType.Cccd && result.Cccd is { } cccd)
{
    Console.WriteLine($"CCCD: {cccd.Id.Value} (Confident: {cccd.Id.Confident})");
    Console.WriteLine($"Tên:  {cccd.Name.Value} (Confident: {cccd.Name.Confident})");
    Console.WriteLine($"Đ/c:  {cccd.Residence.Value}");
}

3. Tải và suy luận với Python (ONNXRuntime)

from huggingface_hub import hf_hub_download
import onnxruntime as ort

repo_id = "truonggiabao7/ocrdoc-models"

# Tải file trọng số
det_path = hf_hub_download(repo_id=repo_id, filename="detection.onnx")
rec_path = hf_hub_download(repo_id=repo_id, filename="recognition.onnx")
dict_path = hf_hub_download(repo_id=repo_id, filename="charset.txt")

# Khởi tạo session
det_session = ort.InferenceSession(det_path, providers=["CPUExecutionProvider"])
rec_session = ort.InferenceSession(rec_path, providers=["CPUExecutionProvider"])

⚙️ Ràng buộc Kỹ thuật khi Tự Cấu hình Recognizer

• Độ phân giải đầu vào cố định: Model được huấn luyện ở [3, 48, 320]. Recognizer chỉ nên chạy ở 2 bậc chiều rộng cố định: 320 (văn bản thường) và 640 (cho dòng MRZ dài). Kích thước động sẽ làm giảm tới 8.5% độ chính xác.
• Normalization: Chuẩn hoá pixel về (x / 255.0 - 0.5) / 0.5.

📜 Giấy phép (License)

• Model weights tuân thủ giấy phép Apache-2.0 (PaddleOCR).
• Mã nguồn và pipeline OcrDoc tuân thủ giấy phép MIT License.