phobert-vi-moderation-v1.1

PhoBERT Contextual Content Moderation v1.1

<p align="center"> <img src="https://img.shields.io/badge/Language-Vietnamese-blue.svg" alt="Language"> <img src="https://img.shields.io/badge/Task-Content--Moderation-green.svg" alt="Task"> <img src="https://img.shields.io/badge/Base--Model-vinai%2Fphobert--base--v2-orange.svg" alt="Base Model"> <img src="https://img.shields.io/badge/Framework-PyTorch%20%7C%20ONNX-red.svg" alt="Framework"> <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License"> </p>

Model Description

PhoBERT Moderation v1.1 is a fine-tuned sequence classification model based on vinai/phobert-base-v2 for contextual text moderation in Vietnamese social networks, with a dedicated focus on mental health awareness and crisis intervention.

Traditional keyword-based moderation often struggles to distinguish between harmless personal venting and actual malicious hate speech, or fails to detect acute emotional distress. This model implements a nuanced 4-class taxonomy:

• CLEAN (An toàn / Tích cực)
• PROFANITY_VENTING (Xả bực dọc / Chửi thề vô hại)
• HATE_SPEECH (Thù ghét / Công kích xúc phạm)
• SELF_HARM_CRISIS (Khủng hoảng tâm lý / Nguy cơ tự hại)

Trained on a curated Vietnamese social corpus integrating UIT-ViHSD and localized mental health crisis data. Both standard PyTorch weights and high-efficiency ONNX Runtime (FP32 & Dynamic INT8) artifacts are included for production serving.

---

🏷️ Contextual Taxonomy & Moderation Actions

---

Model Formats & Artifacts

---

How to Use

1. Using Hugging Face pipeline

from transformers import pipeline

moderator = pipeline(
    task="text-classification",
    model="huyleit/phobert-vi-moderation-v1.1", # Or local folder path
    tokenizer="huyleit/phobert-vi-moderation-v1.1"
)

text = "Mệt mỏi và bế tắc quá rồi, không biết phải tiếp tục thế nào..."
prediction = moderator(text)
print(prediction)

2. Using PyTorch (transformers)

import torch
from transformers import AutoTokenizer, AutoModelForSequenceClassification

model_id = "huyleit/phobert-vi-moderation-v1.1"
tokenizer = AutoTokenizer.from_pretrained(model_id)
model = AutoModelForSequenceClassification.from_pretrained(model_id)

id2label = {
    0: "CLEAN",
    1: "PROFANITY_VENTING",
    2: "HATE_SPEECH",
    3: "SELF_HARM_CRISIS"
}

text = "Đm lại trễ xe buýt nữa, bực cả mình đi làm muộn!"
inputs = tokenizer(text, return_tensors="pt", max_length=128, truncation=True)

with torch.no_grad():
    logits = model(**inputs).logits
    probs = torch.softmax(logits, dim=-1)

pred_id = torch.argmax(probs, dim=-1).item()
confidence = probs[0][pred_id].item()

print(f"Predicted Label: {id2label[pred_id]} (Confidence: {confidence:.4f})")

3. Using ONNX Runtime (Fast CPU Inference)

import numpy as np
import onnxruntime as ort
from transformers import AutoTokenizer

model_id = "huyleit/phobert-vi-moderation-v1.1"
tokenizer = AutoTokenizer.from_pretrained(model_id)

# Load ONNX quantized INT8 model for ultra-fast CPU inference
session = ort.InferenceSession("onnx/phobert_moderation_int8.onnx", providers=["CPUExecutionProvider"])

id2label = {
    0: "CLEAN",
    1: "PROFANITY_VENTING",
    2: "HATE_SPEECH",
    3: "SELF_HARM_CRISIS"
}

text = "Đồ thứ ngu dốt, biến đi cho khuất mắt tao!"
inputs = tokenizer(text, return_tensors="np", max_length=128, truncation=True)

ort_inputs = {
    "input_ids": inputs["input_ids"],
    "attention_mask": inputs["attention_mask"]
}
logits = session.run(["logits"], ort_inputs)[0]
pred_id = int(np.argmax(logits, axis=1)[0])

print(f"Predicted Label: {id2label[pred_id]}")

---

Evaluation Results

Evaluated on an independent, held-out test set of 2,441 samples (evaluation/moderation/data/v1.1/test.json).

Classification Report (Held-out Test Set)

💡 Key Highlight: The model achieves an outstanding 98.13% F1-score on SELF_HARM_CRISIS (Precision: 98.39%, Recall: 97.87%), ensuring high reliability when triggering urgent mental health interventions.

Runtime & Quantization Benchmark Comparison

---

Training Details

Training Data

• Dataset Composition: Merged dataset of UIT-ViHSD (Vietnamese Hate Speech Detection) and localized mental health / crisis corpora.
• Split Ratio: Stratified 70% Train / 15% Validation / 15% Test (2,441 samples held out).

Training Hyperparameters

• Base Architecture: vinai/phobert-base-v2 (135M parameters)
• Max Sequence Length: 128
• Batch Size: 32
• Learning Rate: 2e-5
• Optimizer: AdamW (weight_decay = 0.01)
• Warmup Steps: 300
• Precision: Mixed Precision FP16
• Optimization Metric: Validation Macro F1 (eval_f1)
• Hardware: Google Colab NVIDIA Tesla T4 GPU

---

Label Mapping

{
  "0": "CLEAN",
  "1": "PROFANITY_VENTING",
  "2": "HATE_SPEECH",
  "3": "SELF_HARM_CRISIS"
}

---

Limitations and Bias

• Context-dependent Sarcasm: Sarcastic remarks containing superficially polite words may be misclassified as CLEAN.
• Dialect & Slang: Heavily misspelled words or emerging internet acronyms may diminish detection sensitivity.
• Human Disagreement: Distinguishing borderlines between emotional frustration (PROFANITY_VENTING) and hostile toxicity (HATE_SPEECH) can carry subjective differences.

---

Citation & Acknowledgements

If you use this model or its quantized variants, please cite the following works:

@article{luu2021vihsd,
  title   = {Constructing a Vietnamese Dataset for Advanced Hate Speech Detection on Social Media},
  author  = {Son T. Luu and Kiet Van Nguyen and Ngan Luu-Thuy Nguyen},
  journal = {ACM Transactions on Asian and Low-Resource Language Information Processing},
  year    = {2021}
}

@inproceedings{phobert,
  title     = {{PhoBERT: Pre-trained language models for Vietnamese}},
  author    = {Dat Quoc Nguyen and Anh Tuan Nguyen},
  booktitle = {Findings of the Association for Computational Linguistics: EMNLP 2020},
  pages     = {1037--1042},
  year      = {2020}
}