Zarethustra-code/mediscan

🩺 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 …