medication-safety / README.md
Lincoln Gombedza
fix: valid HF colorTo value (orange β†’ yellow)
cd8134e

A newer version of the Streamlit SDK is available: 1.55.0

Upgrade
metadata
title: Medication Safety Checker
emoji: πŸ’Š
colorFrom: red
colorTo: yellow
sdk: streamlit
sdk_version: 1.32.0
app_file: streamlit_app.py
pinned: false
license: mit

πŸ’Š Medication Safety Checker

ISMP High-Alert Medications Β· Drug Interactions Β· Safe Dose Ranges Β· LASA Warnings Β· Nine Rights Checklist

Hugging Face GitHub License: MIT ISMP: 2023

No login Β· No API key Β· No cost Β· Built by a nurse, for nurses


Overview

The Medication Safety Checker gives student nurses a free, evidence-based reference tool covering the highest-risk areas of medication administration. Every feature is aligned to current safety standards from ISMP, The Joint Commission, and clinical pharmacology guidelines.

Medication errors are the most common type of medical error β€” this tool helps students build the safety habits that prevent them.


Features

πŸ”” High-Alert Medications

  • 15+ high-alert medications from the ISMP 2023 list
  • Full nursing considerations, monitoring parameters, and antidotes for each
  • Grouped by category: Anticoagulants, Concentrated Electrolytes, Insulin, Opioids, NMBAs, and more
  • Searchable by generic or brand name

⚑ Drug Interaction Checker

  • Enter 2–5 medications to check for clinically significant interactions
  • Live API: Queries the NIH RxNorm Interaction API (free, no key required)
  • Curated database: 20+ pre-loaded major clinical interactions with management guidance
  • Severity levels: CRITICAL / HIGH / MODERATE / MINOR
  • Includes mechanism of action and clinical management for each interaction

πŸ“ Safe Dose Verification

  • 30+ common medications with standard adult dose ranges
  • Enter ordered dose + patient weight β†’ instant safety check
  • Weight-based dosing calculations (mg/kg)
  • Special population flags: renal, hepatic, and elderly caution
  • Nursing notes for each medication

πŸ”€ LASA Drug Warnings

  • 30+ LASA pairs based on the ISMP LASA list and Joint Commission NPSG
  • Filter by Look-Alike, Sound-Alike, or Both
  • Filter by risk level (CRITICAL, HIGH, MODERATE, LOW)
  • Clinical significance and prevention strategy for each pair
  • Includes TALL MAN lettering guidance

βœ… Nine Rights Checklist

  • Interactive pre-administration checklist (9 Rights of Medication Safety)
  • 36 individual verification checks across all nine rights
  • Progress tracking with visual completion bar
  • Covers: Patient, Drug, Dose, Route, Time, Documentation, Reason, Response, Right to Refuse

Nine Rights of Medication Administration

Right Key Verification
1. Right Patient Two identifiers (name + DOB or MRN)
2. Right Drug MAR vs label, check LASA list
3. Right Dose Independent calculation, weight-based if applicable
4. Right Route IV access patent, oral route appropriate
5. Right Time Administration window, last dose check
6. Right Documentation Sign MAR immediately after β€” never before
7. Right Reason Know the indication
8. Right Response Pre/post assessment, expected effect
9. Right to Refuse Respect patient autonomy

ISMP High-Alert Categories Covered

Category Examples
Anticoagulants Heparin, Warfarin, Enoxaparin, Rivaroxaban, Apixaban
Concentrated Electrolytes KCl (IV), Hypertonic NaCl, Magnesium Sulphate
Insulin All types (rapid, short, intermediate, basal)
Opioids Morphine, Hydromorphone, Fentanyl, Methadone
Neuromuscular Blocking Agents Succinylcholine, Rocuronium, Vecuronium
Antineoplastics Methotrexate, Vincristine/Vinblastine
Sedatives/Anaesthetics Propofol
Cardiovascular Digoxin, Amiodarone, Nitroprusside
Hypoglycaemics Sulphonylureas (Glipizide, Glyburide)

Tech Stack

Layer Technology
Frontend Streamlit (Python)
High-Alert DB Curated ISMP 2023 clinical data
Interaction engine NIH RxNorm API (free) + curated database
Dose database Standard adult dose ranges (clinical references)
LASA database ISMP LASA list + Joint Commission NPSG
Hosting Hugging Face Spaces β€” free CPU tier
CI/CD GitHub Actions β†’ auto-deploy on push

No API keys. No paid services. Fully open-source.


Local Development

git clone https://github.com/Clinical-Quality-Artifical-Intelligence/medication-safety.git
cd medication-safety
pip install -r requirements.txt
streamlit run streamlit_app.py

Requirements: Python 3.9+ Β· streamlit Β· requests


About β€” Nursing Citizen Development

Part of the Nursing Citizen Development initiative β€” clinicians building the tools their profession needs.

Related tools:


Disclaimer

For educational purposes only. Not a substitute for clinical judgement, pharmacist consultation, or your institution's medication administration protocols. Always refer to current approved prescribing information and your facility's policies.


License

MIT Β© Nursing Citizen Development / Clinical Quality Artificial Intelligence


Built with 🩺 by Nursing Citizen Development