phobert-vehicle_registration-ner

VietNerm - Đăng ký xe NER Model

PhoBERT-based Named Entity Recognition model for Vietnamese Đăng ký xe documents.

⚠️ DISCLAIMER: SYNTHETIC / MOCKUP DATA

Model này được train hoàn toàn trên dữ liệu giả lập (synthetic/mockup data), KHÔNG sử dụng dữ liệu cá nhân thật.

• Tất cả dữ liệu training được sinh tự động bằng hệ thống template + generator
• Không sử dụng giấy tờ thật, thông tin cá nhân thật, hoặc dữ liệu thu thập từ người dùng
• Số định danh (ID, CCCD...) được sinh ngẫu nhiên, thiết kế để không trùng với dữ liệu thật
• Dữ liệu có inject nhiễu OCR (noise) để giả lập điều kiện thực tế
• Mục đích: nghiên cứu AI, Document AI, OCR/NER pipeline
• Không được sử dụng để giả mạo giấy tờ, tạo giấy tờ giả, lừa đảo hoặc gian lận

Model Description

This model is fine-tuned from vinai/phobert-base for token-level NER on Vietnamese administrative/medical documents. It extracts structured fields from OCR text output.

• Base model: vinai/phobert-base
• Task: Token Classification (NER)
• Language: Vietnamese (vi)
• Document type: Đăng ký xe
• Number of labels: 19
• Training data: Synthetic/Mockup (not real personal data)

Labels

• B-brand
• B-chassis_number
• B-engine_number
• B-expiry_date
• B-manufacture_country
• B-manufacture_year
• B-model_code
• B-owner_address
• B-owner_name
• B-plate_number
• B-registration_date
• B-vehicle_type
• I-manufacture_country
• I-model_code
• I-owner_address
• I-owner_name
• I-plate_number
• I-vehicle_type

Usage

With VietNerm SDK

from vietnerm import VietNerm

ner = VietNerm(doc_type="vehicle_registration", model_path="ngocthanhdoan/phobert-vehicle_registration-ner")
result = ner.extract("your document text here")
print(result)

With Transformers

from transformers import AutoTokenizer, AutoModelForTokenClassification
import torch

tokenizer = AutoTokenizer.from_pretrained("ngocthanhdoan/phobert-vehicle_registration-ner")
model = AutoModelForTokenClassification.from_pretrained("ngocthanhdoan/phobert-vehicle_registration-ner")

text = "your document text here"
inputs = tokenizer(text, return_tensors="pt")

with torch.no_grad():
    outputs = model(**inputs)
    predictions = torch.argmax(outputs.logits, dim=-1)

Training

• Dataset: Synthetically generated (mockup data) with OCR noise simulation
• Data source: Auto-generated from Jinja2 templates + random generators (no real personal data)
• Framework: HuggingFace Transformers + Trainer API
• Optimizer: AdamW (lr=2e-5)
• Epochs: 5-7 (with early stopping)

Ethical Use

This model is built for research and development purposes only:

• ✅ AI/NLP research
• ✅ Document AI development
• ✅ OCR/NER pipeline prototyping
• ✅ Educational purposes
• ❌ Forging documents
• ❌ Creating fake identity papers
• ❌ Fraud or deception

About VietNerm

VietNerm is a Document AI Factory for Vietnamese documents. It provides a complete pipeline from template-based synthetic data generation to model training and deployment.

• Repository: Devhub-Solutions/VietNerm
• Training dataset: ngocthanhdoan/vietnerm-vehicle_registration-dataset
• SDK: pip install vietnerm
• License: MIT — Copyright (c) 2026 Devhub Solutions