How the system actually works

DiabeticDocs is the honest technical record of what we've built. Two halves, one law: OpenDiabetic is the compute + trust foundation (the hive); LocalDiabetic is the home vault and the on-device helper (the bee on your shoulder). Between them sits one rule โ€” the firewall โ€” that never bends.

Every status here is labeled honestly: LIVE = running and verified ยท IN BUILD = partly done ยท FRAMEWORK = designed, not yet a service. No vaporware.

The one law

Private health data (PHI) never leaves your box. Models flow down, receipts flow up, PHI crosses never. The vault holds your records; the cloud only ever receives non-PHI receipts, open models, and templates. Read it in full: The Firewall โ†’

The components

ComponentWhat it doesStatus
LocalDiabetic Home VaultA 15-folder structure on your own NAS holding your records, meds, labs, foot-care logs, appointments. Git-tracked. The only place PHI lives at rest.LIVE
The Nudge (reminder engine)Fires gentle reminders (foot check, meds, appointments). Structurally PHI-blind: it never reads a record โ€” only the generic nudge you declared. Detail stays behind a pointer on the box.LIVE
The Edge BrainAn on-device small model (on a Jetson) that organizes and explains your notes. Processes records in RAM only, never persists PHI, mints a non-PHI receipt for every call.LIVE
Bee (voice)Speak to your vault: on-device speech-to-text (faster-whisper) โ†’ organize โ†’ text-to-speech read-back (Piper). All on-box; audio never leaves.IN BUILD
The Nudge โ†’ your wristSelf-hosted notifications deliver the generic nudge to your phone/watch. Only non-PHI text ever crosses.LIVE
DiabeticModelsSmall open specialist models, cooked on cited corpora, beat-base-proven, hosted to flow down to the edge brain.IN BUILD
Ride / shoe-shippingThe human continuum โ€” a ride to the doctor, diabetic shoes shipped. Real mission, not yet a live service.FRAMEWORK

Read next