bechosen-spec/mamasos

MamaSOS is an offline-first, multilingual maternal emergency voice agent for African communities. # MamaSOS **When she cannot speak, someone else can.** MamaSOS is an open-source, offline-first, multilingual maternal emergency voice communication and referral prototype for African communities. It demonstrates reporter–patient disentanglement in Pidgin-English and code-switched speech: the speaker may be a husband, relative, caregiver, or health worker, while the registered pregnant woman remains the patient. > [!IMPORTANT] > MamaSOS is an emergency communication and referral prototype. It does not diagnose medical conditions, prescribe treatment, replace qualified healthcare professionals, dispatch an ambulance, or guarantee emergency response. ## Competition scenario John reports: “Abeg help me, my wife is eight months pregnant. She dey bleed since morning and now she no fit stand.” MamaSOS identifies John as the husband and reporter, Esther as the registered patient, attributes bleeding and inability to stand to Esther with their evidence sources, applies deterministic urgency rules, creates a critical referral, simulates alerts to Nurse Ada and Hope Maternal Clinic, and exposes a clinic acknowledgement timeline. ## Features - Mobile-first onboarding for patient, emergency contact, clinic, microphone consent, and safety disclosure - MediaRecorder capture with timer, playback, retry, size/type validation, permission errors, and 45-second limit - Isolated Sahara transcription and Gemini structured-extraction adapters with safe credential-free mocks - Visible reporter/patient confirmation and source attribution for every extracted danger sign - Deterministic Python and matching offline JavaScript urgency rules that never return “safe” - Maximum two essential follow-ups, skipped after clear critical evidence - Emergency case, referral, printable/PDF-ready layout, copyable summary, and SMS fallback - IndexedDB audio/case storage, offline tap selections, automatic reconnection sync, and duplicate prevention - Responsive patient history, contact controls, and …