Zarethustra-code/mediscan
Domain:
healthcarenatural language processingRecord type:
software
Creator:
Zar
Host:
🩺 MediScan — upload a prescription or lab-report photo and get a plain-language explanation (EN/Yoruba), powered by local Gemma 4 vision.
# 🩺 MediScan — understand your prescription, on your own device
**Upload a photo of a prescription or lab report → get a calm, plain-language explanation
you can read _or hear_, in English or Yorùbá.** MediScan runs **Gemma 4 locally** (Ollama or
HuggingFace) — no cloud, no account, nothing leaves the machine.
Built for the **Google Gemma 4 Hackathon**.
> ⚠️ **MediScan helps you _understand_ a prescription or lab result. It is NOT a substitute
> for a licensed doctor or pharmacist.** It never diagnoses, never prescribes, and never tells
> you to start, stop, or change a dose. Always confirm with a qualified professional. **Not for
> emergencies.**
---
## The problem, and why it matters
Billions of people are handed a prescription or a lab printout they can't fully read:
handwriting, abbreviations (`1 tab TID p.c.`), drug names, and lab values like `HbA1c 8.4%
(ref 4–6)` that mean nothing without context. The consequences are real — missed doses, doubled
doses, ignored abnormal results, dangerous drug combinations. The people most affected often
have **low literacy, limited English, or poor eyesight**, and **little or no internet** — exactly
the situations where a cloud medical app fails them.
MediScan targets that gap: a tool that works **fully offline on a modest laptop**, explains the
document in **the user's own language**, can **read the explanation aloud**, and is **honest about
its limits** — pointing people back to a professional instead of pretending to be one.
---
## What it does
1. **Reads the image** with Gemma 4's native vision — medications (name, dose, instructions) and
lab tests (value + reference range).
2. **Explains it in plain language** — English or **Yorùbá**.
3. **Flags things worth checking** — abnormal lab values, "do-not-exceed" notes, well-known drug
interactions, and an always-on "confirm with a professional" reminder.
4. **Builds a daily plan** — a Morning / Afternoon / Night organiser **derived deterministically
in Python** (se …