---

💚 The colors that power MedSathi

#2ecc71 — Life Green     #1a6b3c — Deep Medical     #0d1f0d — Dark Background     #e74c3c — Emergency Red

---

🌍 The Problem — 700 Million People Without Healthcare

It is 2 AM in a village near Jhansi, Uttar Pradesh. A 60-year-old man has chest pain and difficulty breathing. The nearest hospital is 47 kilometres away. There is no doctor to call. No reliable information available. His family guesses. They wait. They hope.

This is not a rare situation. This is everyday life for 700 million rural Indians.

• 🏥 6 lakh villages in India have no primary health centre
• 👨‍⚕️ 1 doctor per 1,700 people in rural areas vs WHO recommendation of 1 per 1,000
• 📵 Limited internet in remote areas makes online search unreliable
• 🌐 Language barrier — most health information is in English only

MedSathi was built to solve this — by someone from Jhansi, for people who look like his neighbours.

---

🏥 What is MedSathi?

MedSathi (meaning Health Friend in Hindi) is an AI-powered health assistant built specifically for rural India using Google Gemma 3.

Users describe symptoms in Hindi or English and instantly receive:

✅  Simple, jargon-free health guidance
✅  Possible causes explained in plain language
✅  Home remedies and self-care steps
✅  Clear warning signs requiring immediate attention
✅  Emergency alerts with helpline numbers (108, 104)

"Not a doctor. Not a replacement. A knowledgeable friend who is always available."

---

📊 Impact at a Glance

🌍 Target Population	🗣️ Languages	💊 Symptoms	⏰ Availability	💰 Cost	🚨 Emergency
700M+ Rural Indians	Hindi & English	6+ Quick Buttons	24 / 7	Completely Free	Auto-Detect

---

🚀 Features

╔══════════════════════════════════════════════════════════════════════════╗
║                       MEDSATHI FEATURE PIPELINE                         ║
╠════════════════════╦══════════════════════════════╦═════════════════════╣
║  Feature           ║  What It Does                ║  Why It Matters     ║
╠════════════════════╬══════════════════════════════╬═════════════════════╣
║  🤖 Gemma 3 AI     ║  Powers all health responses ║  Accurate & Fast    ║
║  🌐 Bilingual      ║  Hindi + English support     ║  Reaches 500M+      ║
║  🚨 Emergency      ║  Auto-detects critical cases ║  Can save lives     ║
║  💊 Quick Buttons  ║  6 one-click symptoms        ║  Easy for elders    ║
║  ⌨️  Typing Anim   ║  Word-by-word AI response    ║  Natural & engaging ║
║  🎨 Dark UI        ║  Green medical theme         ║  Professional look  ║
║  🔒 Secure         ║  API key via .env secrets    ║  Production ready   ║
║  📱 Responsive     ║  Works on mobile & desktop   ║  Rural mobile users ║
╚════════════════════╩══════════════════════════════╩═════════════════════╝

---

🤖 How Gemma 3 Powers MedSathi

MedSathi uses gemma-3-4b-it — Google's instruction-tuned Gemma 3 model — with a carefully engineered system prompt that:

• Forces simple, non-technical language appropriate for rural users
• Enforces a structured response format (Causes → Home Care → Warning Signs → Doctor Visit)
• Detects emergency symptoms and triggers immediate alert protocols
• Switches language mode based on user's selection (Hindi/English)
• Never gives a confirmed diagnosis — always recommends professional consultation

# Gemma 3 powers MedSathi's intelligence
response = client.models.generate_content(
    model="gemma-3-4b-it",
    contents=full_prompt  # System prompt + user symptoms
)

---

🚨 Emergency Detection System

MedSathi automatically scans every Gemma response for emergency keywords:

English triggers  →  "EMERGENCY", "AMBULANCE", "IMMEDIATELY"
Hindi triggers    →  "आपातकाल", "तुरंत", "अस्पताल"

When triggered:

• 🔴 Pulsing red alert box appears instantly
• 📞 Emergency numbers displayed: Ambulance 108 | Health 104 | Police 100
• ⚠️ Bold warning to go to hospital immediately

This feature exists because in rural India, people often cannot tell when a situation is life-threatening.

---

🏗️ How It Works

         User opens MedSathi
                  ↓
         Selects Language (Hindi / English)
                  ↓
         Types symptoms OR clicks quick button
                  ↓
         Gemma 3 processes with medical system prompt
                  ↓
    ┌─────────────────────────────────┐
    │  Emergency keyword detected?    │
    │  YES → 🚨 Red pulsing alert     │
    │  NO  → Normal structured reply  │
    └─────────────────────────────────┘
                  ↓
         Word-by-word typing animation
                  ↓
         Always ends: "Please visit a doctor"

---

🛠️ Tech Stack

AI Model    →  Google Gemma 3 (gemma-3-4b-it)  —  Core intelligence engine
API         →  Google AI Studio                  —  Free Gemma API access
Frontend    →  Streamlit                         —  Rapid UI development
Language    →  Python 3.x                        —  Application logic
Styling     →  Custom CSS + Animations           —  Medical green dark theme
Fonts       →  Google Poppins                    —  Clean, readable typography
Security    →  python-dotenv                     —  API key protection
Hosting     →  Streamlit Cloud                   —  Free live deployment
Version     →  Git + GitHub                      —  Source control

---

🏃 Run Locally

# 1. Clone the repository
git clone https://github.com/DeveshShukla23/MedSathi.git
cd MedSathi

# 2. Install dependencies
pip install streamlit google-genai python-dotenv

# 3. Create .env file with your API key
echo "GOOGLE_API_KEY=your_google_ai_studio_key" > .env

# 4. Run the app
streamlit run app.py

# 5. Open browser at http://localhost:8501

---

📂 Project Structure

MedSathi/
│
├── 📄 app.py              ←  Main Streamlit application (Gemma 3 powered)
├── 📄 requirements.txt    ←  Python dependencies for Streamlit Cloud
├── 📄 .env                ←  API key — NOT pushed to GitHub (protected)
├── 📄 .gitignore          ←  Protects .env from accidental exposure
└── 📄 README.md           ←  This file

---

💼 Why MedSathi Can Win

🎯  REAL PROBLEM   —  700M rural Indians genuinely lack healthcare access
🤖  GEMMA 3 CORE   —  Not a wrapper. Gemma is the intelligence engine.
🌐  EDGE READY     —  Lightweight enough for low-bandwidth rural areas
🗣️  HINDI FIRST    —  Most AI health tools are English-only. Not MedSathi.
🚨  SAVES LIVES    —  Emergency detection is not a gimmick. It is critical.
❤️  PERSONAL STORY —  Built by someone from Jhansi, for his own community

---

👨‍💻 Built By

Devesh Shukla Data Analyst & Generative AI Developer Jhansi, Uttar Pradesh, India

"I built MedSathi because I have seen what happens when a village has no doctor and no information. Gemma 3 gave me the power to do something about it."

⭐ If MedSathi inspired you, please give it a star! ⭐