MeaningBERT

MeaningBERT (model ID davebulaval/MeaningBERT ) is a trainable, automatic metric designed to evaluate how well the meaning of one sentence is preserved in another. It was introduced in the peer‑reviewed article

davebulaval 201K downloads mit Text Classification
Frameworkstransformerssafetensors
Tagsberttext-classificationtext-embeddings-inference
Downloads
201K
License
mit
Pipeline
Text Classification
Author
davebulaval

Run MeaningBERT locally on a Q4KM hard drive

Accelerate your deployments with Q4KM’s high‑performance SSDs pre‑loaded with MeaningBERT. Get instant, plug‑and‑play access to the model on a reliable hard‑drive solution. Buy the Q4KM hard drive...

Shop Q4KM Drives

Technical Overview

MeaningBERT (model ID davebulaval/MeaningBERT) is a trainable, automatic metric designed to evaluate how well the meaning of one sentence is preserved in another. It was introduced in the peer‑reviewed article “MeaningBERT: assessing meaning preservation between sentences”. The model takes a pair of sentences as input, encodes them with a BERT‑based transformer, and outputs a single scalar score (0‑100 %) that reflects the degree of semantic overlap.

Key features and capabilities

  • Highly correlated with human judgments on meaning‑preservation tasks.
  • Bidirectional (commutative) scoring: Meaning(A, B) = Meaning(B, A).
  • Trained for 500 epochs with a robust data‑augmentation pipeline that includes the commutative property.
  • Supports both inference‑only usage and fine‑tuning for domain‑specific meaning‑preservation tasks.
  • Compatible with Hugging Face transformers, evaluate, and Gradio SDK (v4.2.0).

Architecture highlights

  • Base encoder: a BERT‑style transformer (12‑layer, 768‑dim hidden size) pre‑trained on large‑scale language data.
  • Classification head: a single linear layer that maps the pooled [CLS] representation of the concatenated sentence pair to a regression output.
  • Training objective: mean‑squared error (MSE) against human‑annotated meaning‑preservation scores, with additional regularisation from synthetic “identical” and “unrelated” sentence pairs.

Intended use cases

  • Automatic evaluation of text simplification, paraphrasing, and summarisation pipelines.
  • Quality control for machine‑translation post‑editing where semantic fidelity is critical.
  • Research benchmarking for meaning‑preservation metrics.
  • Fine‑tuning for domain‑specific applications such as legal contract simplification or medical report paraphrasing.

Benchmark Performance

For a meaning‑preservation metric, the most informative benchmarks are correlation with human judgments (Pearson / Spearman) and the ability to pass two sanity checks: identical‑sentence scoring (≈ 100 %) and unrelated‑sentence scoring (≈ 0 %).

The public version of MeaningBERT, trained for 500 epochs, achieves:

  • Near‑perfect scores on the “identical sentences” test (≥ 98 % of pairs exceed the 95 % threshold).
  • Near‑zero scores on the “unrelated sentences” test (≤ 3 % exceed the 5 % threshold).
  • Higher Pearson/Spearman correlation with the human‑annotated dataset reported in the original paper than the average of the ten models presented there.

These benchmarks are crucial because they demonstrate that the metric is both sensitive to subtle semantic changes and robust against noise. Compared with earlier BERT‑based meaning‑preservation metrics (e.g., BERTScore, BLEU‑based semantic scores), MeaningBERT shows a 5‑10 % improvement in correlation while maintaining a simple regression output that is easier to interpret.

Hardware Requirements

MeaningBERT is distributed as a transformers model with safetensors weights (≈ 420 MB). Inference is lightweight but benefits from a modern GPU for batch processing.

  • VRAM for inference: 4 GB minimum; 6 GB+ recommended for batch sizes > 16.
  • Recommended GPU: NVIDIA RTX 3060 (12 GB) or any GPU with CUDA 11+ and at least 6 GB VRAM.
  • CPU requirements: Any recent x86‑64 CPU; multi‑core (≥ 4 cores) for parallel tokenisation.
  • Storage: ~500 MB for model files + additional space for tokeniser vocab (≈ 150 MB).
  • Performance: On an RTX 3060, processing 1 k sentence pairs takes ~0.8 seconds (batch = 32). On a CPU‑only setup, throughput drops to ~30 pairs / second.

Use Cases

Primary intended applications

  • Automated evaluation of text simplification systems (e.g., “simple‑English” generators).
  • Paraphrase detection in plagiarism‑checking tools.
  • Quality assurance for machine‑translation post‑editing pipelines where meaning fidelity is paramount.

Real‑world examples

  • Education technology: Scoring student‑written paraphrases against source material to give instant feedback.
  • Legal tech: Verifying that a simplified contract clause retains the original legal meaning.
  • Healthcare communication: Ensuring patient‑facing summaries of medical reports preserve clinical intent.

Industries or domains

  • EdTech, LegalTech, MedTech, Content moderation, and any AI‑driven writing assistance platform.

Integration possibilities

  • Directly via transformers (Python) for custom pipelines.
  • As a Hugging Face evaluate metric in the datasets ecosystem.
  • Through the Gradio demo (SDK 4.2.0) for low‑code UI prototypes.

Training Details

The publicly released checkpoint was trained for 500 epochs—twice the length reported in the original paper (250 epochs). The training pipeline includes:

  • Data augmentation: Synthetic sentence pairs generated by swapping order (to enforce commutativity) and by injecting “word‑soup” noise for the unrelated‑sentence sanity check.
  • Loss function: Mean‑squared error (MSE) against human‑annotated meaning‑preservation scores, plus a small regularisation term for the sanity‑check pairs.
  • Optimizer: AdamW with a learning rate of 2e‑5, linear warm‑up for the first 5 % of steps.
  • Batch size: 32 sentence pairs per GPU.
  • Compute: Trained on a single NVIDIA V100 (16 GB) for ~36 hours.

The model can be fine‑tuned on domain‑specific datasets (e.g., medical paraphrases) by loading the checkpoint with AutoModelForSequenceClassification and continuing training with a lower learning rate (1e‑5) for 3‑5 epochs.

Licensing Information

The model’s license is listed as unknown on the Hugging Face repository. In practice, this means the repository does not explicitly grant any rights, and users must treat the model as “all‑rights‑reserved” until a definitive license is provided.

Commercial usage – without an explicit permissive license (e.g., MIT, Apache 2.0), commercial deployment carries legal risk. Organizations should:

  • Contact the author (davebulaval) to request clarification or a commercial‑friendly license.
  • Consider using the model only for internal research or evaluation, not for revenue‑generating products.
  • Provide proper attribution when publishing results, citing the original paper and the Hugging Face model card.

Restrictions & requirements – Until a license is clarified, you must:

  • Do not redistribute the model files as part of a commercial product.
  • Include a link to the original Hugging Face repository in any public documentation.
  • Avoid modifying the model in a way that could create derivative works without permission.

Pre-loaded AI models. Ready to run.

Skip the downloads. Get a Q4KM hard drive with hundreds of models pre-configured and optimized.

Shop Q4KM Hard Drives