Shookla AI (शुक्ल) 🩺🎙️

India's First Ambient Clinical AI Platform --- Open Source & Built for Bharat.

Shookla is an ambient clinical intelligence platform designed specifically for the Indian healthcare ecosystem. It listens to doctor-patient consultations in native Indian languages, automatically generates structured clinical notes, and makes health records accessible to patients via a multilingual voice assistant.

---

🌟 The Core Idea

India has 1.3 million doctors, and each loses an average of 2--4 hours daily to manual paperwork. Meanwhile, patients often struggle to read or understand complex medical prescriptions written in English.

Shookla solves both problems simultaneously:

1️⃣ For Doctors

It acts as an invisible AI scribe.
Doctors simply speak naturally with patients (Hindi, Marathi, English, Tamil, or code-mixed languages).

Shookla will:

• Listen to the consultation

• Extract the chief complaint

• Flag risks

• Generate a perfect SOAP note

• Generate a prescription

✅ Zero typing required

2️⃣ For Patients

It acts as a 24/7 Voice Assistant.

Patients can ask questions like:

"What are my medicines?"

In their native language, and Shookla AI will:

• Read their prescription aloud

• Explain medicines simply

• Provide accessible health records

---

👥 Who is this for?

🩺 Medical Professionals

• General Physicians (MBBS)

• AYUSH Practitioners (BAMS, BHMS, BUMS)

• Dentists (BDS)

• Specialists (Cardiology, Pediatrics, Gynecology)

🙏 Patients

Anyone needing a digital, accessible, voice-first health record that moves with them.

🏥 Clinics & Hospitals

Organizations looking for ABDM-ready and DPDP-2023 compliant digitization.

💻 Open Source Developers

Developers interested in building indigenous HealthTech solutions for the next billion users.

---

✨ Key Features

🎙️ Ambient Voice Scribe

Real-time speech-to-text powered by Sarvam Saaras v3, trained on Indian accents and medical terminology.

🧠 Clinical AI Analysis

Automatic extraction of:

• ICD-10 codes

• Differential diagnoses

• Weight-based dosage calculations

Powered by Sarvam-M.

🗣️ Patient Voice Assistant

Multilingual assistant using Bulbul v3 that answers patient questions in 22 Indian languages.

🩺 Specialty-Specific UI

Custom dashboards for:

• Ayurveda (Prakriti / Dosha tracking)

• Homeopathy (Repertorisation)

• Dentistry (Odontograms)

🇮🇳 ABHA & ABDM Ready

Architecture designed to integrate with Ayushman Bharat Digital Mission.

🔐 Client-Side API Key Management

Users can input their Sarvam + Firebase keys directly in the UI, with no backend required.

---

🛠️ Tech Stack

Layer	Technology
Frontend	React 19 + Vite
Styling	Tailwind CSS v3
Routing	React Router v7
Database & Auth	Firebase (Firestore, Authentication)
AI Models	Sarvam AI (Saaras v3, Bulbul v3, Sarvam-M, Sarvam Vision)
Markdown Parsing	Marked.js

---

🚀 For Open Source Developers

Shookla AI is designed to be extremely easy to run locally.

It includes a Demo Mode, allowing the full UI and logic to run without any database or API keys.

---

📦 Prerequisites

• Node.js v18+

• npm or yarn

---

1️⃣ Installation

Clone the repository and install dependencies.

git clone https://github.com/yourusername/Shookla AI-app.git
cd Shookla AI-app
npm install

---

2️⃣ Force Tailwind v3 (Important)

Shookla AI relies on Tailwind CSS v3.

If you encounter PostCSS parsing errors, run:

npm install -D tailwindcss@3 postcss autoprefixer

---

3️⃣ Running the App

Start the development server:

npm run dev

Then open:

http://localhost:5173

---

4️⃣ Demo Mode vs Production Mode

Demo Mode (Default)

• Mock patients

• Mock queues

• Local localStorage persistence

• Simulated AI timers

No API keys required.

---

Live Mode

To connect real services:

1. Open Settings inside the Shookla AI UI

2. Add:

   • Firebase project credentials

   • Sarvam AI API key

The app will:

• Save them securely to localStorage

• Switch instantly to Live Mode

---

📁 Directory Structure

Shookla AI-app/
├── public/ # Favicon, icons, static assets
├── src/
│ ├── assets/ # Images, SVGs
│ ├── components/
│ │ ├── auth/ # Login & Setup Wizards
│ │ ├── layout/ # Appbar, Sidebar, AppShell
│ │ └── ui/ # Reusable UI components
│ ├── context/ # Global State (AppContext, AuthContext)
│ ├── pages/
│ │ ├── doctor/ # Dashboard, Consultation, Queue, Scan
│ │ ├── patient/ # Dashboard, AskAI, Timeline, Prescriptions
│ │ ├── LandingPage.jsx
│ │ └── Settings.jsx
│ ├── services/
│ │ ├── firebase.js
│ │ └── sarvam.js
│ ├── utils/
│ │ ├── constants.js
│ │ └── i18n.js
│ ├── App.jsx
│ ├── index.css
│ └── main.jsx
├── tailwind.config.js
└── vite.config.js

---

🤝 Contributing

We welcome contributions from the community.

Examples:

• Adding new Indian language translations

• Improving AI prompt accuracy

• Adding new medical specialties

Contribution Workflow

1. Fork the repository

2. Create a feature branch

git checkout -b feature/AmazingFeature

1. Commit changes

git commit -m "Add AmazingFeature"

1. Push

git push origin feature/AmazingFeature

1. Open a Pull Request

---

🧩 Good First Issues

• Add Gujarati, Bengali, Kannada translations in src/utils/i18n.js

• Improve Markdown rendering CSS in AskAI.jsx

• Implement PDF prescription export

---

📜 License

Distributed under the MIT License.
See LICENSE for more information.

---

🙏 Acknowledgements

Built for the doctors and patients of Bharat 🇮🇳

Powered by Sarvam AI foundational models for Indian languages.

---

✅ Next Steps

1. Copy this content

2. Create README.md in your project root

3. Paste and save

4. Replace yourusername in the GitHub URL

5. Push to GitHub

---

If you want, I can also show you 3 ways to make this README look even more impressive on GitHub (with screenshots, demo GIF, architecture diagram, and badges) so it looks like a top-tier open source project. 🚀

make it all impressive. give read.me format so i can copy and paste

Below is a polished, impressive, GitHub-grade README.md designed like top open-source projects (Stripe, Supabase, Next.js style).
It includes:

• Hero section

• Demo section

• Architecture

• Feature grid

• Developer onboarding

• Roadmap

• Contributors

• Better structure for GitHub visibility

You can copy-paste directly into README.md.

---

🩺 Shookla AI (वैद्य)

India's First Ambient Clinical AI Platform

Open Source - Voice-First - Built for Bharat 🇮🇳

Ambient AI that listens to doctor-patient conversations, generates structured clinical notes, and gives patients a multilingual voice assistant for their health records.

---

🎥 Demo

(Add screenshots or GIFs here once UI is ready)

/docs/demo-dashboard.png
/docs/demo-consultation.png
/docs/demo-patient-assistant.png

Example:

---

🚀 What is Shookla AI?

Shookla AI is an Ambient Clinical Intelligence Platform designed for the Indian healthcare ecosystem.

It automatically:

• 🎙️ Listens to doctor-patient consultations

• 🧠 Extracts medical insights

• 📝 Generates structured clinical documentation

• 🗣️ Explains prescriptions to patients in their language

All without disrupting the doctor's workflow.

---

🇮🇳 The Problem in India

India has:

• 1.3 million doctors

• 700M+ patients with limited digital access

• Paper-based clinical workflows

Doctors spend 2-4 hours daily on documentation.

Patients often:

• Cannot read prescriptions

• Forget medication instructions

• Lose medical history

---

💡 The Solution

Shookla AI provides two AI copilots:

👨‍⚕️ Doctor Copilot

An ambient AI scribe that listens and generates:

• SOAP notes

• Diagnoses

• ICD-10 codes

• Prescriptions

• Risk alerts

Doctors simply talk naturally with patients.

Zero typing required.

---

🧑‍⚕️ Patient Copilot

A voice assistant for health records.

Patients can ask:

"What medicines am I taking?"

"When should I take my tablet?"

Shookla AI responds in their native language.

---

✨ Key Features

🎙️ Ambient Voice Scribe

Powered by Sarvam Saaras v3

• Indian accent recognition

• Medical terminology support

• Real-time transcription

---

🧠 Clinical AI Engine

Automatic extraction of:

• ICD-10 codes

• Differential diagnoses

• Weight-based drug dosage

Powered by Sarvam-M.

---

🗣️ Patient Voice Assistant

Multilingual assistant powered by Bulbul v3.

Supports 22 Indian languages.

---

🩺 Specialty-Specific UI

Custom interfaces for:

• Ayurveda (Dosha tracking)

• Homeopathy (Repertorisation)

• Dentistry (Odontograms)

• General Medicine

• Pediatrics

---

🇮🇳 ABDM & ABHA Ready

Designed for integration with Ayushman Bharat Digital Mission.

Future features:

• ABHA ID sync

• Health record portability

• National health stack interoperability

---

🔐 Client-Side API Key Management

Users add:

• Sarvam AI API key

• Firebase credentials

Directly inside the UI.

No backend required to start.

---

🏗️ Architecture

Doctor Conversation
│
▼
Sarvam Saaras v3
Speech-to-Text
│
▼
Clinical AI Engine
(Sarvam-M LLM)
│
▼
Structured Medical Data
│
▼
Firebase Firestore
│
▼
Patient Voice Assistant
(Bulbul v3 TTS/STT)

---

🛠️ Tech Stack

Frontend

• React 19

• Vite

• Tailwind CSS v3

• React Router v7

Backend Services

• Firebase Firestore

• Firebase Authentication

AI Models

Provided by Sarvam AI

Model	Purpose
Saaras v3	Speech-to-Text
Bulbul v3	Text-to-Speech
Sarvam-M	Clinical reasoning
Sarvam Vision	Document scanning

---

📦 Installation

Prerequisites

• Node.js 18+

• npm or yarn

---

Clone Repository

git clone https://github.com/yourusername/Shookla AI-app.git
cd Shookla AI-app

---

Install Dependencies

npm install

---

Ensure Tailwind v3

If you encounter CSS errors:

npm install -D tailwindcss@3 postcss autoprefixer

---

Start Development Server

npm run dev

Open:

http://localhost:5173

---

🧪 Demo Mode

Shookla AI includes a built-in Demo Mode.

No APIs required.

Features:

• Mock patients

• Mock queue

• LocalStorage persistence

• Simulated AI responses

Perfect for:

• UI testing

• Open source contributions

• Hackathons

---

🔴 Live Mode

To connect real services:

1. Open Settings in the UI

2. Add:

   • Firebase credentials

   • Sarvam API key

The app automatically switches to Live Mode.

---

📂 Project Structure

Shookla AI-app
│
├── public
│ ├── icons
│ └── favicon
│
├── src
│
│ ├── assets
│ │ └── images
│
│ ├── components
│ │
│ ├── auth
│ ├── layout
│ └── ui
│
│ ├── context
│ │ ├── AppContext
│ │ └── AuthContext
│
│ ├── pages
│ │
│ ├── doctor
│ ├── patient
│ ├── LandingPage.jsx
│ └── Settings.jsx
│
│ ├── services
│ │ ├── firebase.js
│ │ └── sarvam.js
│
│ ├── utils
│ │ ├── constants.js
│ │ └── i18n.js
│
│ ├── App.jsx
│ ├── main.jsx
│ └── index.css
│
├── tailwind.config.js
└── vite.config.js

---

🤝 Contributing

We welcome contributors building India's health tech future.

Workflow

1️⃣ Fork repository

2️⃣ Create feature branch

git checkout -b feature/new-feature

3️⃣ Commit changes

git commit -m "Add new feature"

4️⃣ Push

git push origin feature/new-feature

5️⃣ Open Pull Request

---

🧩 Good First Issues

• Add translations for

  • Gujarati

  • Bengali

  • Kannada

File:

src/utils/i18n.js

Other ideas:

• Improve Markdown rendering in AskAI.jsx

• Add PDF prescription generation

• Improve AI prompt structure

---

🗺️ Roadmap

Phase 1

• Core AI Scribe

• Doctor Dashboard

• Patient Assistant

Phase 2

• Prescription OCR

• Medical document scanner

• Offline clinic mode

Phase 3

• ABHA integration

• Hospital dashboards

• Mobile app

---

🌍 Vision

Build India's open healthcare AI infrastructure.

Accessible to:

• Urban hospitals

• Rural clinics

• ASHA workers

• Patients with low literacy

---

📜 License

MIT License

See LICENSE file.

---

🙏 Acknowledgements

Built for Doctors and Patients of Bharat 🇮🇳

Powered by Sarvam AI

---

⭐ Support the Project

If you like this project:

⭐ Star the repository
🍴 Fork it
🧠 Contribute improvements

---

Creator

Built with ❤️ for India's healthcare future.