A 568M XLM-RoBERTa model for detecting personal and clinical identifiers in English clinical and biomedical text.
Runs locally after download on Python CPU, in the browser, and on Android.

OpenMed | Documentation | Model collection | Paper

Model

Field	Value
Task	PII token classification
Language	English
Architecture	XLM-RoBERTa
Parameters	568M (568,000,000)
Maximum sequence length	512 tokens
Entity labels	`account_number`, `age`, `api_key`, `bank_routing_number`, `biometric_identifier`, `blood_type`, `certificate_license_number`, `city`, `company_name`, `coordinate`, `country`, `county`, `credit_debit_card`, `customer_id`, `cvv`, `date`, `date_of_birth`, `date_time`, `device_identifier`, `education_level`, `email`, `employee_id`, `employment_status`, `fax_number`, `first_name`, `gender`, `health_plan_beneficiary_number`, `http_cookie`, `ipv4`, `ipv6`, `language`, `last_name`, `license_plate`, `mac_address`, `medical_record_number`, `occupation`, `password`, `phone_number`, `pin`, `political_view`, `postcode`, `race_ethnicity`, `religious_belief`, `sexuality`, `ssn`, `state`, `street_address`, `swift_bic`, `tax_id`, `time`, `unique_id`, `url`, `user_name`, `vehicle_identifier`
Source model	`OpenMed/OpenMed-PII-ClinicalBGE-Large-568M-v1`
License	apache-2.0

OpenMed in Python on CPU

pip install --upgrade "openmed[onnx-runtime]"

python

from openmed import OnnxModel

model = OnnxModel.from_pretrained("OpenMed/OpenMed-PII-ClinicalBGE-Large-568M-v1-onnx-android")
entities = model("Patient Alice Nguyen can be reached at alice@example.org.")

for entity in entities:
    print(entity.to_dict())

OpenMed selects the CPU-oriented INT8 graph by default and returns labels, confidence scores, exact character offsets, and source text.

OpenMed in Web

npm install openmed @huggingface/transformers onnxruntime-web

typescript

import { loadOnnxModel } from "openmed";

const repo = "OpenMed/OpenMed-PII-ClinicalBGE-Large-568M-v1-onnx-android";
const model = await loadOnnxModel(repo);
const entities = await model("Patient Alice Nguyen can be reached at alice@example.org.");

The default INT8 path runs with WebAssembly. For WebGPU, select the FP16 graph:

typescript

const model = await loadOnnxModel(repo, {
  variant: "fp16",
  device: "webgpu",
});

OpenMedKit for Android

Add JitPack to the consumer application's settings.gradle.kts:

kotlin

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven {
            url = uri("https://jitpack.io")
            content { includeGroup("com.github.maziyarpanahi") }
        }
    }
}

Use the latest OpenMed build from the master branch:

kotlin

dependencies {
    implementation("com.github.maziyarpanahi:openmed:master-SNAPSHOT")
}

After downloading this model repository into an app-controlled directory:

kotlin

import com.openmed.openmedkit.OpenMedKit

OpenMedKit.fromDirectory(modelDirectory).use { model ->
    val entities = model.analyzeText("Patient Alice Nguyen can be reached at alice@example.org.")
}

Inference and tokenization remain on-device.

Included Artifacts

Artifact	Recommended use
`model_int8.onnx`	CPU, WebAssembly, and Android default
`model_fp16.onnx`	WebGPU and compatible accelerated runtimes
`model.onnx`	Full-precision reference
`tokenizer.json`	Cross-platform tokenizer
`openmed-onnx.json`	Runtime contract and operator metadata

All graphs use opset 18, dynamic batch and sequence axes, stable tensor names, and source-text offset metadata.

The OpenMed Ecosystem

This model is part of OpenMed, an Apache-2.0, local-first clinical AI stack:

2,000+ medical models for clinical NER, biomedical extraction, and privacy.
PII detection and de-identification across 55+ identifier types and 17 languages.
Python, MLX, Swift, Android, React Native, Web, REST, and gRPC runtimes.
Structured and multimodal intake for OCR, documents, DICOM, FHIR, and HL7.
Offline and air-gapped deployment with no telemetry by default.

Intended Use and Limitations

This model is intended for detecting personal and clinical identifiers. It does not diagnose conditions or make clinical decisions. Evaluate recall, thresholds, and span behavior on appropriately governed data before deployment. Local execution supports privacy-preserving workflows but does not by itself guarantee regulatory compliance.

All examples in this card are synthetic.

Citation

bibtex

@misc{panahi2025openmedneropensourcedomainadapted,
  title={OpenMed NER: Open-Source, Domain-Adapted State-of-the-Art
         Transformers for Biomedical NER Across 12 Public Datasets},
  author={Maziyar Panahi},
  year={2025},
  eprint={2508.01630},
  archivePrefix={arXiv},
  primaryClass={cs.CL}
}