"Water, water, everywhere, nor any drop to drink..." — Samuel Taylor Coleridge was clearly trying to get a straight answer out of six different medical specialists who all lost his lab results.
If you’ve ever had a chronic health issue, you know the drill. You walk into a new doctor’s office, sit on that paper-covered table, and suddenly you’re expected to recall every symptom, dosage change, and weird side effect you’ve had since the monsoon of 2024. "What was that round white pill again? Why did I stop taking it? Did it make my knee itch or was that just a mosquito?"
Welcome to Project Odyssey, a patient-owned, memory-driven healthcare platform. Born out of the collective trauma of medical memory loss, Odyssey is here to make sure your health story stays complete, connected, and under your control—without making you feel like you’re filling out tax forms at 3:00 AM.
The Core Concept: A Vault with a Mind of Its Own
At its heart, Odyssey is a longitudinal, timestamped memory of a patient’s entire illness journey: symptoms, lab tests, doctor visits, treatment responses, and—our personal favorite—a Ruled-Out Ledger. Because in medicine, knowing what you don't have is half the battle.
Instead of dumping everything into a black hole of unorganized PDFs, Odyssey uses Hindsight as its memory and reasoning engine. Everything you do gets logged into an isolated, patient-specific memory bank.
┌─────────────────────────────────────────────────────────────────┐
│ THE ODYSSEY STACK │
│ │
│ [ Telegram Bot ] ───► [ FastAPI Backend ] ───► [ Postgres ] │
│ (Taps, Voice, (Auth, Consent, (Source of │
│ Hinglish/Malayalam) Guardrail Code) Truth) │
│ │ │
│ ▼ │
│ [ Hindsight ] │
│ (Retain, Recall, Reflect) │
│ │ │
│ ▼ │
│ [ Free AI Engine: Groq + Gemini ] │
└─────────────────────────────────────────────────────────────────┘
When you ask Odyssey a question, it doesn't invent fantasy medical facts. It recalls exact timestamped events from your private bank.
1. Zero Blank Fields, Zero Headaches: Onboarding & The Telegram Bot
Nobody wants to fill out a 50-field web form when they're sick. Odyssey completely replaces clunky forms with two super-accessible channels:
Conversational Onboarding: You talk naturally in regional languages (like Malayalam, Hindi, or English). Our LLM extracts structured facts (allergies, meds, conditions) using strict JSON schemas. Unfilled items stay as
unknown—never blank fields—and the system casually asks missing details over time.Tap-First Telegram Micro-Cards: Instead of typing long essays, our Telegram bot serves up quick inline check-in cards. 3 buttons, a
Something elseoption, and a⏭ Skipbutton.Voice Notes & Photo Capture: Send a 10-second voice note in Hinglish ("pet mein jalan ho rahi hai") or snap a photo of a prescription strip. Groq Whisper transcribes the audio, Gemini Vision parses the prescription, and Odyssey presents a tap-to-confirm card before saving anything.
2. Intelligence That Actually Makes Sense (No AI Hallucinations!)
We know what you’re thinking: "Is an AI going to tell me my headache is a rare tropical disease?" Absolutely not. Odyssey runs on deterministic code before generative language model magic touches it.
Pattern Spotter
- How It Works: Runs Python statistical tests like lagged cross-correlation and Fisher exact tests (with a minimum $n \ge 6$)[cite: 1].
- Patient View: "Hey, your joint flares spike 24 hours after sleeping under 5 hours."[cite: 1] (Actively suppresses false correlations like "coffee causes flares" if evidence is lacking!)[cite: 1]
Ruled-Out Ledger
- How It Works: Tracks clinical tests, who excluded what diagnosis, and evidence conclusiveness[cite: 1].
- Patient View: "Lupus ruled out by Dr. Rao on Aug 12 based on ANA test."[cite: 1]
Red-Flag Detector
- How It Works: Deterministic multilingual keyword and rule checks run before the LLM processes text[cite: 1].
- Patient View: Detects chest pain or breathlessness $\rightarrow$ immediately halts chat and displays emergency helpline numbers[cite: 1].
Memory-Off Toggle
-
How It Works: A server-level flag (
memory=off) that completely bypasses Hindsight recall[cite: 1]. - Patient View: Lets you test what the AI knows with vs. without memory in real-time[cite: 1].
3. The Doctor's View: Finally, an AI That Cites Its Sources
Doctors don't have time to read 400 pages of scattered notes. Odyssey gives clinicians a supercharged, clean dashboard:
Visit Prep & After-Visit Capture: Before an appointment, Odyssey generates a crisp 1-Page Visit Prep Brief ranking open loops, symptom trends, and questions you shouldn't forget to ask. Afterwards, drop a voice note of what the doctor said, and Odyssey extracts follow-up promises, new prescriptions, and lab dates.
Patient-Locked Chatbot: Clinicians can query the patient's record using an AI locked to that specific
patient_idat the server level. The chatbot cites exact source IDs for every claim—and if something isn't in the record, it plainly states "Not in this patient's record" instead of guessing. Zero cross-patient data leakage!Medication Safety & Conflict Flags: Checks new prescriptions against past adverse reactions, allergies, and stopped drugs, highlighting patient-reported vs. doctor-entered discrepancies with full provenance.
4. Sick Notes Without the Drama: Doctor-Verified Certificates
Need a medical certificate for college, your IT employer, or a flight cancellation?
Request: Request a certificate via Web or Telegram, choosing how much detail to disclose (defaults to a general fitness statement to protect privacy).
Draft & Approve: Odyssey’s template engine drafts the certificate. The doctor reviews it on their queue, edits if needed, and approves it with their registration seal.
Delivery & Verification: The final PDF lands directly in your Telegram with a 4.5 cm blank header space for official clinic letterheads and a QR code. Scanning the QR code takes anyone to a public
/verify/{cert_id}page confirming its validity—without revealing private medical details!
5. Family Connect: Remote Care Without Being a Stalker
Managing an elderly parent's health from another city usually involves awkward phone calls and constant nagging. Odyssey introduces Family Connect:
Two-Sided Consent Matrix: Parents choose exactly what family members can see (e.g.,
alerts only,summary, orfull access). Sensitive categories (like mental or reproductive health) can be excluded with a single toggle.Family Health Tree: A 3-generation hereditary graph that flags family-wide condition patterns without making wild genetic predictions.
Graduated Alerts & Child Dashboard: Adult children get a clean dashboard ("Amma took 2 of 3 meds today"). If a critical check-in is missed, Odyssey nudges the parent first before escalating to the family.
6. The Free AI Stack & 7 Layers of Ironclad Guardrails
We built Odyssey to be fast, privacy-focused, and completely free of costly API dependencies:
┌─────────────────────────────────────────────────────────────────┐
│ THE 7-LAYER GUARDRAIL SYSTEM │
│ │
│ [1. Session Auth] ──► Model never picks the patient ID │
│ [2. Input Screen] ──► Red-flag & injection rules run first │
│ [3. Anonymization] ──► PII stripped before external LLM calls│
│ [4. Retrieval Gate] ──► Grounding strictly from patient bank │
│ [5. JSON Schemas] ──► Constrained function outputs[cite: 1] │
│ [6. Output Filter] ──► Citation validator & diagnosis scrub │
│ [7. Action Controls]──► Model cannot prescribe/sign/change DB │
└─────────────────────────────────────────────────────────────────┘
By combining Groq Whisper for lightning-fast speech processing, Gemini Flash for multimodal document parsing, FastAPI + Postgres for deterministic state, and Hindsight for longitudinal context, Odyssey delivers enterprise-grade medical memory on a $0 stack.
Final Verdict
Medical history doesn't have to be a tragicomedy of lost papers, forgotten drug names, and repetitive questionnaires. With Odyssey, every symptom, test, and doctor’s promise is woven into a single, intelligent narrative that stays entirely in your hands.
Because while life is full of mysteries, what happened to your health in 2024 definitely shouldn't be one of them!

Top comments (0)