Skip to main content
Jonathan Andrei
Back to all posts
Feb. 2025 - Mar. 20256 min read

FHIR + CDS Hooks + Gemini: a Risk Score a Clinician Will Actually Read

Risk scores die when they're black boxes. MeldRx integration via FHIR/CDS Hooks pulls patient data; Gemini Flash returns structured JSON with explanations, confidence, and recommended actions; the UI hands clinicians a downloadable PDF report.

FHIRCDS HooksGeminiHealthcare

Risk-prediction widgets that bolt onto an EHR get ignored when they don't explain themselves. The MeldRx Hackathon was an excuse to design the explanation surface first and let the model fit into it.

Structured output is non-negotiable

Gemini Flash is asked for strict JSON with fields the UI relies on: risk_score, confidence, drivers, suggested_actions. Retry logic on malformed responses guarantees the contract. If the model returns prose, we re-ask. The downstream UI never has to defensive-parse.

Active vs resolved is the visualization that earned its space

Most condition lists treat everything as current. A clinician's brain doesn't. The dashboard splits active and resolved conditions visually, surfaces the most common diagnoses across the panel, and exports the consolidated summary as a downloadable PDF — the artifact a clinician actually saves to the chart.

Related project

Predictive AI Healthcare Assistant (MeldRx Hackathon)

View the project