🧬 Setu Health — Multimodal Patient Timeline & Drug Interaction Graph

AI-powered medical record analyser that extracts medications from documents, visualises drug interactions as a graph, and answers clinical questions in natural language.

---

🌐 Live Demo

👉 Click here to use Setu Health

No installation needed — open the link, enter your Google API key, and upload your medical documents.

---

📌 What is Setu Health?

Setu Health is a prototype clinical intelligence tool that helps patients and healthcare professionals make sense of complex medication histories. Upload any medical document — prescriptions, lab reports, handwritten notes, or discharge summaries — and the app will:

• 🔍 Extract all medications using Google Gemini 2.5 Flash (AI vision + structured JSON output)
• 🕸 Map drug relationships and concurrent-use overlaps as an interactive graph
• 📅 Visualise a Gantt-style medication timeline
• 💬 Answer natural language questions about your medication history

---

✨ Features

Feature	Description
📂 Multi-file Upload	PDF, JPG, PNG, WEBP — prescriptions, notes, scans
🤖 AI Extraction	Gemini 2.5 Flash extracts name, dosage, frequency, dates, condition, side effects
🕸 Drug Interaction Graph	NetworkX + Plotly interactive graph with overlap detection
📅 Medication Timeline	Gantt chart showing active vs ended medications over time
⚠️ Overlap Flags	Automatically detects and highlights concurrent medication use
💬 Query Engine	Ask questions like "What side effects should I watch for this week?"
🔒 Secure	API key never stored — entered per session or via environment variable

---

🚀 How to Use the Live App

1. Open → https://setu-health-2fkzmhofvnf24g8p83fa7t.streamlit.app/
2. Get a free Google API key → https://aistudio.google.com/app/apikey
3. Paste your API key in the sidebar
4. Upload your medical documents (PDF, JPG, PNG)
5. Click ⚡ Analyse Documents
6. Explore the graph, timeline, and ask questions!

---

💻 Run Locally

Prerequisites

• Python 3.10 or higher → Download
• A free Google API key → Get it here

Installation

1. Clone the repository

git clone https://github.com/AishwaryaMohanty212/setu-health.git
cd setu-health

2. Install dependencies

pip install -r requirements.txt

3. Set your Google API key

# macOS / Linux
export GOOGLE_API_KEY="AIza...your_key..."

# Windows CMD
set GOOGLE_API_KEY=AIza...your_key...

# Windows PowerShell
$env:GOOGLE_API_KEY="AIza...your_key..."

4. Run the app

streamlit run app.py

5. Open your browser at

http://localhost:8501

---

📁 Project Structure

setu-health/
├── app.py              # Main Streamlit application
├── requirements.txt    # Python dependencies
├── run_app.py          # One-click launcher
└── README.md           # You are here

---

🧠 How It Works

┌─────────────────┐     ┌──────────────────────┐     ┌───────────────────┐
│  Upload Files   │────▶│  Gemini 2.5 Flash AI  │────▶│  Structured JSON  │
│ PDF / JPG / PNG │     │  Vision + Extraction   │     │  Medication Data  │
└─────────────────┘     └──────────────────────┘     └────────┬──────────┘
                                                               │
                    ┌──────────────────────────────────────────▼──────────┐
                    │                  NetworkX Graph                      │
                    │   Medication Nodes ←→ Condition Nodes                │
                    │   TREATS edges  |  CONCURRENT_USE overlap edges      │
                    └──────────────┬───────────────────────────────────────┘
                                   │
               ┌───────────────────┼────────────────────────┐
               ▼                   ▼                         ▼
      Plotly Graph View    Gantt Timeline View       Query Engine
      (Interactive)        (Active vs Ended)     (Gemini + Graph Context)

---

💬 Example Questions You Can Ask

• "What side effects should I watch for this week?"
• "Which of my medications have potential interactions?"
• "Am I currently taking any overlapping medications?"
• "Summarise my complete medication history."
• "Which condition has the most medications prescribed?"
• "What medications ended in the last 6 months?"

---

🛠 Tech Stack

Tool	Purpose
Streamlit	Web UI framework
Google Gemini 2.5 Flash	AI document analysis & Q&A
NetworkX	Graph data structure
Plotly	Interactive graph & timeline visualisation
Pandas	Data handling

---

⚠️ Disclaimer

Setu Health is a prototype for educational and research purposes only. It is not a substitute for professional medical advice, diagnosis, or treatment. Always consult a qualified healthcare provider for medical decisions.

---

🤝 Contributing

Contributions are welcome!

• Open an Issue for bugs or feature requests
• Submit a pull Request with improvements

---

📄 License

This project is licensed under the MIT License — free to use, modify, and distribute.

---

👩‍💻 Author

Aishwarya Mohanty

• GitHub: @AishwaryaMohanty212
• Live App: setu-health.streamlit.app

---

Built with ❤️ for better healthcare accessibility