sahidawa-india

🩺 SahiDawa — सही दवा

India’s First Open-Source Citizen Medicine Verifier & Rural Health Bridge

Scan any medicine. Verify it’s real. Find safe pharmacies near you. Talk to an AI doctor in your language.

Built for Bharat. Not just India.

Report a Bug · Request a Feature · Join Discord · Read the Docs

Table of Contents

• 🩺 SahiDawa — सही दवा
• 🚨 The Problem We’re Solving
• ✨ What SahiDawa Does
• 🏗️ Architecture
• 🛠️ Tech Stack
• 🗺️ Roadmap & Phases
• 🚀 Getting Started
• 📁 Project Structure
• 🤝 Contributing
• 🌏 Supported Languages
• 📊 Data Sources (All Free & Public)
• 🏆 GSSoC 2026
• 💬 Community
• 📜 License
• 👥 Contributors
• 🙏 Acknowledgements
• ❤️ Why Open Source?

🚨 The Problem We’re Solving

India has a three-layer healthcare crisis that no existing platform solves simultaneously:

Real incident: In July 2025, Delhi Police busted a counterfeit medicine ring supplying fake Johnson & Johnson and GSK medicines — made of chalk powder and starch — all the way into government hospitals. Patients had zero way to verify these medicines before consuming them.

SahiDawa fixes this. For free. Forever. Open source.

✨ What SahiDawa Does

💡 The Core Workflow

• 📱 Scan Medicine ➔ 🔍 AI Verifies (CDSCO) ➔ ✅ Real / ⚠️ Suspicious / ❌ Fake
• 🗣️ Speak Symptoms ➔ 🤖 AI Triage (22 Languages) ➔ 🏥 Find Nearest Pharmacy
• 📸 Report Fakes ➔ 🗺️ Community Heatmap ➔ 📢 District-Level Alerts

Core Features (Currently in active development)

🏗️ Architecture

🛠️ Tech Stack

Frontend

• Next.js 16 — React 19 framework with App Router + SSR
• Tailwind CSS 4.0 — High-performance utility-first CSS
• shadcn/ui — UI components
• Workbox — PWA offline caching
• @zxing/browser — In-browser barcode/QR scanning
• Leaflet.js + OpenStreetMap — Maps (free, no API key)
• next-intl — i18n for 22 Indian languages

Backend

• Node.js 22 + Express 5.0 + TypeScript — API server
• Redis (Upstash free tier) — Drug lookup caching
• FastAPI + Python — ML microservice

AI / ML

• OpenCV.js — In-browser image analysis
• TensorFlow Lite — On-device packaging classifier
• Whisper (self-hosted) — Voice input, 22 languages
• Sarvam AI — Indian language LLM
• LangChain — RAG pipeline + agent orchestration

Database & Storage

• PostgreSQL + PostGIS — Primary DB + geo queries
• pgvector — Vector search for RAG
• Supabase — Managed Postgres (free tier for dev)
• Cloudinary — Medicine photo storage + image analysis (GSSoC 2026 bounty partner)

Infrastructure

• Docker + Docker Compose — Containerization
• GitHub Actions — CI/CD
• Vercel — Frontend deployment (free)
• Railway — Backend deployment (free tier)

🗺️ Roadmap & Phases

Phase 1 — Foundation & Core Scanner (Pre-GSSoC / Early May)

• Project scaffolding (Next.js + TypeScript + Tailwind)
• CDSCO drug database scraper + PostgreSQL schema
• Barcode/QR scanner UI (ZXing)
• Medicine lookup REST API
• Supabase integration
• GitHub Actions CI pipeline
• English UI with i18n setup

Phase 2 — Map + Multilingual + Offline (Coding Begins - Mid May)

• PostGIS pharmacy + ASHA worker map (Leaflet.js)
• i18n system — 22 Indian language JSON files
• Cloudinary photo upload integration
• Offline PWA (Workbox cache strategies)
• FastAPI ML microservice scaffolding
• Redis caching for drug lookups
• OpenCV.js packaging geometry detection

Phase 3 — AI Health Assistant + Agents (Main Contribution Period - June)

• TF Lite medicine image classifier
• Whisper ASR voice input (22 languages)
• Sarvam AI + LangChain RAG health assistant
• CDSCO drug alert monitoring agent (LangChain)
• Counterfeit heatmap + D3.js visualization
• Push notification system for district alerts

Phase 4 — Polish, Security & Launch (Final Evaluations - July)

• WCAG 2.1 accessibility audit
• Lighthouse CI (target 90+ score)
• Docker Compose for self-hosting
• OpenAPI/Swagger documentation
• ABHA health card integration (optional)
• Public launch

🚀 Getting Started

Prerequisites

node >= 20.0.0
python >= 3.10
docker >= 24.0 (optional, for full stack)

Quick Start (Frontend only)

# 1. Clone the repository
git clone https://github.com/RatLoopz/sahidawa-india.git
cd sahidawa-india

# 2. Copy environment variables
cp .env.example apps/web/.env.local
# Fill in your Supabase URL + anon key (free at supabase.com)

# 3. Install frontend dependencies
cd apps/web
npm install

# 4. Run development server
npm run dev
# Open http://localhost:3000

⚠️ Troubleshooting npm install Failures

If you encounter No matching version found errors while running npm install, it may be caused by the canary package versions used in this project.

Try running:

npm install --legacy-peer-deps

or:

npm install --force

If the issue still persists, you may temporarily downgrade package versions locally to get the project running on your machine.

⚠️ Important: Do not commit modified package.json or package-lock.json files created during local downgrades. Revert those changes before pushing your PR.

Full Stack with Docker

# Clone and start everything
git clone https://github.com/RatLoopz/sahidawa-india.git
cd sahidawa-india

cp .env.example .env
# Edit .env with your keys

docker compose up --build
# Frontend:  http://localhost:3000
# API:       http://localhost:4000
# ML service: http://localhost:8000
# API Docs:  http://localhost:4000/api/docs

Manual Backend Setup

# Ensure environment variables are set at the project root
cp .env.example .env
# Edit .env with your keys

# Start API Server
cd apps/api
npm install
npm run dev
# API Docs: http://localhost:4000/api/docs

ML Service (Python)

For detailed setup instructions, see: ML Setup Guide

For local setup instructions, see: Local Setup Guide

Quick start:

cd apps/ml
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload --port 8000

📁 Project Structure

sahidawa-india/
├── apps/
│   ├── web/                    # Next.js PWA frontend
│   │   ├── app/                # App Router pages
│   │   ├── components/         # Reusable UI components
│   │   ├── lib/                # Utilities, API clients
│   │   ├── messages/           # i18n JSON files (22 languages)
│   │   │   ├── en.json
│   │   │   ├── hi.json
│   │   │   ├── ta.json
│   │   │   └── ...             # one file per language
│   │   └── public/             # Static assets
│   ├── api/                    # Node.js + Express API
│   │   ├── src/
│   │   │   ├── routes/         # API route handlers
│   │   │   ├── services/       # Business logic
│   │   │   ├── middleware/     # Auth, rate limiting
│   │   │   └── db/             # Database models + migrations
│   │   └── tests/
│   └── ml/                     # Python FastAPI ML service
│       ├── routers/            # ML API endpoints
│       ├── models/             # TF Lite models
│       ├── services/           # Whisper, OpenCV, LangChain
│       └── agent/              # CDSCO monitoring agent
├── packages/
│   └── shared/                 # Shared TypeScript types
├── data/
│   └── seeds/                  # CDSCO drug database seeds
├── docs/                       # Project documentation
├── .github/
│   ├── workflows/              # GitHub Actions CI/CD
│   ├── ISSUE_TEMPLATE/         # Bug report, feature request templates
│   └── PULL_REQUEST_TEMPLATE.md
├── docker-compose.yml
├── docker-compose.dev.yml
└── README.md

🤝 Contributing

We love contributions! SahiDawa is built entirely by the community.

👉 Read the CONTRIBUTING.md before submitting your first PR.

Quick contribution guide

1. Check open issues — look for good-first-issue label
2. Comment on the issue saying you want to work on it
3. Fork → branch → code → test → PR
4. A maintainer will review within 24 hours

What can I contribute?

🌏 Supported Languages

SahiDawa aims to support all 22 Indian scheduled languages. (We are just getting started! Help us translate.)

📊 Data Sources (All Free & Public)

🏆 GSSoC 2026

This project is participating in GirlScript Summer of Code 2026 under both:

• 📂 Open Source Track — 10 labeled issues (Coming Soon) for all skill levels
• 🤖 Agents for India Track — CDSCO autonomous alert agent (Coming Soon)

We are also a Cloudinary Bounty Partner project — contributors who build features using Cloudinary’s Media API earn bonus GSSoC leaderboard points.

💬 Community

• Discord: Join SahiDawa Discord
• GitHub Discussions: Discuss ideas & questions

📜 License

SahiDawa is licensed under the MIT License — free to use, modify, distribute, and deploy.

See LICENSE for full text.

👥 Contributors

Thank you to all the incredible people who have contributed to making SahiDawa a reality! 🙌

🙏 Acknowledgements

• GirlScript Foundation for GSSoC 2026
• CDSCO for the public drug database
• Sarvam AI for Indian language models
• Cloudinary for media infrastructure & GSSoC bounty partnership
• Every contributor who believes healthcare is a right, not a privilege

❤️ Why Open Source?

Healthcare accessibility should not depend on income, location, or language.

SahiDawa is community-driven and built to remain free forever.