OpenSafety 🩺

OpenSafety is an open-source Pharmacovigilance (PV) AI toolkit powered by the OpenSafety-1.5B foundation model and deterministic MedDRA v28.0 ontology verification for:

1. Adverse Drug Reaction (ADR) Extraction from raw clinical text.
2. MedDRA Coding (LLT, Preferred Term, and Primary System Organ Class).
3. Regulatory Listedness Assessment against Reference Safety Information (RSI / Product Labels).

Installation

pip install opensafety

Quick Start: End-to-End AI Pharmacovigilance

from opensafety import OpenSafetyEngine

# 1. Initialize the engine (automatically loads the OpenSafety-1.5B model)
engine = OpenSafetyEngine()

# 2. Analyze a raw patient narrative
report = engine.analyze(
    drug="Atorvastatin",
    narrative="A 62-year-old female taking Atorvastatin 40mg daily developed acute muscle weakness and soreness in her calves.",
    rsi="Section 4.8 Undesirable Effects: Common: myalgia, arthralgia, pain in extremity, muscle spasms."
)

# 3. Inspect verified regulatory output
for event in report.adverse_events:
    print(f"Verbatim: {event.verbatim}")
    print(f"MedDRA PT: {event.meddra_pt} (Code: {event.meddra_pt_code})")
    print(f"Primary SOC: {event.meddra_soc}")
    print(f"Listedness: {event.listedness.status}")
    print(f"Rationale: {event.listedness.rationale}")
    print(f"Validation: {event.validation_status}")

Instant MedDRA v28.0 Dictionary & Fuzzy Search

from opensafety import MedDRADatabase, HybridMedDRAMatcher

# Exact dictionary lookup (89,774 LLTs & 26,920 PTs)
db = MedDRADatabase("meddra.db")
res = db.search_term("Dry cough")
print(res[0]["pt_name"])  # "Cough"
print(res[0]["soc_name"]) # "Respiratory, thoracic and mediastinal disorders"

# Colloquial fuzzy matching for patient expressions
matcher = HybridMedDRAMatcher("meddra.db")
matches = matcher.search("stomach ache", top_k=1)
print(matches[0]["pt_name"])  # "Abdominal pain upper"

Architecture: Hybrid Safety Engine

[ Clinical Narrative / Case Report ] + [ Reference Safety Info (RSI) ]
                                  │
                                  ▼
               OpenSafety-1.5B Clinical Foundation Model
                                  │
                                  ▼
                     Extracted Structured JSON
                                  │
                                  ▼
         Deterministic MedDRA v28.0 SQLite Verification
            (Zero hallucination, verified 8-digit codes)
                                  │
                                  ▼
              Validated ICH E2B(R3) Structured Report

License

Apache License 2.0. MedDRA is copyrighted by the International Council for Harmonisation (ICH) and maintained by MSSO.