---
title: Nursing Language Translator
emoji: 🏥
colorFrom: blue
colorTo: indigo
sdk: gradio
sdk_version: "4.44.0"
app_file: app.py
pinned: false
license: apache-2.0
short_description: Translate NHS clinical shorthand to formal language
---

# 🏥 Nursing Language Translator

[![Hugging Face Spaces](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-blue)](https://huggingface.co/spaces/NurseCitizenDeveloper/Nursing-Language-Translator)
[![Model](https://img.shields.io/badge/%F0%9F%A4%97%20Model-NurseEmbed--300M-orange)](https://huggingface.co/NurseCitizenDeveloper/NurseEmbed-300M)
[![License](https://img.shields.io/badge/License-Apache%202.0-green.svg)](https://opensource.org/licenses/Apache-2.0)

**Translate NHS clinical shorthand to formal language using AI.**

Powered by [NurseEmbed-300M](https://huggingface.co/NurseCitizenDeveloper/NurseEmbed-300M), a clinical embedding model fine-tuned on NHS nursing terminology.

## 🚀 Try It Now

**Live Demo:** https://huggingface.co/spaces/NurseCitizenDeveloper/Nursing-Language-Translator

## ✨ Features

| Feature | Description |
|---------|-------------|
| 🔤 **170+ NHS Abbreviations** | SOB, NEWS2, NOF, UTI, COPD, AF, LMWH, etc. |
| ⚠️ **NEWS2 Interpretation** | Automatic risk scoring with clinical actions |
| 🧠 **Semantic Matching** | AI-powered translation, not just string matching |
| 📊 **Confidence Scores** | See how confident the model is in each translation |
| 📚 **Reference Guide** | Browse all abbreviations by category |

## 📝 Example

**Input:**
```
72M c/o SOB, NEWS2 score is 7, PMH: COPD, AF. Started on Salbutamol NEB and LMWH.
```

**Output:**

| Term | Translation | Category |
|------|------------|----------|
| `72M` | 72-year-old Male | Demographics |
| `c/o` | complaining of | Assessment |
| `SOB` | Shortness of Breath | Respiratory |
| `NEWS2 7` | 🔴 High risk - Emergency response required | Assessment |
| `PMH` | Past Medical History | History |
| `COPD` | Chronic Obstructive Pulmonary Disease | Respiratory |
| `AF` | Atrial Fibrillation | Cardiovascular |
| `NEB` | Nebuliser | Route |
| `LMWH` | Low Molecular Weight Heparin | Medication |

## 🛠️ Local Installation

```bash
# Clone the repository
git clone https://github.com/Clinical-Quality-Artifical-Intelligence/nursing-language-translator.git
cd nursing-language-translator

# Install dependencies
pip install -r requirements.txt

# Run the app
python app.py
```

Open http://localhost:7860 in your browser.

## 📁 Project Structure

```
nursing-language-translator/
├── app.py                  # Main Gradio application
├── knowledge_base.json     # 170+ NHS abbreviations database
├── requirements.txt        # Python dependencies
└── README.md               # This file
```

## 🧠 How It Works

1. **Input Parsing**: Extracts individual terms and phrases from clinical text
2. **Semantic Embedding**: Uses NurseEmbed-300M to create vector representations
3. **Knowledge Base Matching**: Finds the closest matching abbreviation in the database
4. **NEWS2 Detection**: Automatically identifies and interprets Early Warning Scores
5. **Translation Generation**: Produces formal clinical language with confidence scores

## 📊 Model Performance

NurseEmbed-300M was trained using a two-stage hybrid approach:

| Stage | Dataset | Samples | Performance |
|-------|---------|---------|-------------|
| Stage 1 (Medical) | `miriad-4.4M-split` | 10,000 | 81.3% Acc@1 |
| Stage 2 (Nursing) | Custom NHS dataset | 200 | 95.4% Acc@10 |

## 🏷️ Abbreviation Categories

- **Assessment**: NEWS2, MUST, Waterlow, AVPU, GCS
- **Respiratory**: SOB, COPD, URTI, LRTI, O2 sats
- **Cardiovascular**: AF, MI, PE, DVT, CCF
- **Medications**: LMWH, GTN, PRN, STAT, OD/BD/TDS
- **Routes**: IV, IM, SC, PO, PR, NEB
- **Investigations**: CXR, ECG, FBC, U&E, CT, MRI
- **Locations**: A&E, AMU, ITU, HDU, CCU
- **And 10+ more categories...**

## 🤝 Contributing

Contributions are welcome! To add new abbreviations:

1. Fork the repository
2. Edit `knowledge_base.json` to add new entries
3. Submit a pull request

## 📄 License

This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.

## 👨‍⚕️ Author

**Lincoln Gombedza** ([@NurseCitizenDeveloper](https://huggingface.co/NurseCitizenDeveloper))

- 🏥 Registered Learning Disability Nurse
- 🎓 Practice Educator
- 💻 Co-Chair, Digital & Technology Working Group NHS Professional Strategy for Nursing and Midwifery
- 🚀 Founder, Nursing Citizen Development Movement

## 🔗 Related Projects

- [NurseEmbed-300M](https://huggingface.co/NurseCitizenDeveloper/NurseEmbed-300M) - The embedding model
- [NurseSim-Triage](https://huggingface.co/spaces/NurseCitizenDeveloper/NurseSim-Triage) - AI triage training
- [The Virtual Ward](https://huggingface.co/spaces/NurseCitizenDeveloper/The-Virtual-Ward) - RL environment for ward management

---

<p align="center">
  Built with ❤️ for NHS Nurses
</p>