Connecting Hospitals. Saving Lives. A smart platform providing real-time bed availability, blood inventory tracking, ambulance dispatch, and AI-powered hospital recommendations for government and private hospitals.

MedGrid is a state-of-the-art healthcare management platform designed to bridge the gap between hospitals, ambulances, and patients. By providing real-time data on bed availability and blood inventory, MedGrid ensures that no time is lost when it matters most.

Whether you are a hospital administrator managing ICU beds, an ambulance driver en route to an emergency, or a patient searching for the nearest hospital — MedGrid serves as your intelligent healthcare companion.

• Live Availability: Track ICU, General, NICU, and Emergency beds across all registered hospitals in real time.
• Staff Portal: Hospital staff can toggle bed availability, manage departments, and batch-save updates with a single click.
• Patient View: Patients can see available beds at any hospital before arriving.

• Live Inventory: Real-time blood unit counts for all 8 blood groups (A+, A−, B+, B−, AB+, AB−, O+, O−).
• Blood Donor Registration: Citizens can register as blood donors via a comprehensive form.
• Email Confirmation: Donors automatically receive a confirmation email with the nearest hospital's details and next steps.

• Emergency Case Management: Ambulances can raise emergency cases and get matched to the best hospital.
• AI Hospital Recommendation: AI recommends the optimal hospital based on location, bed availability, and blood group.
• Real-Time ETA: Tracks ambulance status (Pending → Enroute → Arrived → HandedOver).

• Intelligent Q&A: Ask about hospitals, doctors, bed availability, and blood inventory in natural language.
• ChromaDB Vector Store: Powered by Sentence Transformers + ChromaDB for semantic search.
• LLM Integration: Uses microsoft/Phi-3-mini-4k-instruct via Hugging Face Inference API.

• Profile Management: Update hospital details, specialties, and operating hours.
• Doctor Management: Add doctors, toggle on-shift/on-call status.
• Patient Records: View and manage patient medical records.
• Emergency Dashboard: Real-time emergency case notifications with accept/confirm workflow.

• Hospital Search: Search hospitals by name or location.
• Hospital Details: View beds, blood inventory, doctors, and patient reviews.
• Review System: Submit star ratings and comments for hospitals.

┌─────────────────────────────────────────────────────┐
│                  Frontend Layer                      │
│         React + TypeScript + Tailwind CSS            │
│  ┌──────────┐  ┌──────────┐  ┌────────────────────┐ │
│  │Dashboard │  │StaffPortal│  │Patient/Ambulance   │ │
│  └──────────┘  └──────────┘  └────────────────────┘ │
└─────────────────────────────────────────────────────┘
                        │ REST API (Axios)
┌─────────────────────────────────────────────────────┐
│               Backend Layer (Django)                 │
│  ┌──────────────┐  ┌──────────────┐  ┌───────────┐  │
│  │ Hospitals API│  │ Chatbot API  │  │ Auth API  │  │
│  └──────────────┘  └──────────────┘  └───────────┘  │
└─────────────────────────────────────────────────────┘
                        │
┌─────────────────────────────────────────────────────┐
│                  Data & AI Layer                     │
│  ┌──────────┐  ┌──────────┐  ┌────────────────────┐ │
│  │ SQLite DB│  │ ChromaDB │  │ HuggingFace LLM    │ │
│  └──────────┘  └──────────┘  └────────────────────┘ │
└─────────────────────────────────────────────────────┘

• Node.js v18+
• Python v3.9+
• Git

git clone https://github.com/Esingh-byte/medgrid.git
cd medgrid

cd medgrid_server

# Create and activate virtual environment
python -m venv venv

# Windows
venv\Scripts\activate
# Mac/Linux
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Run migrations
python manage.py migrate

# (Optional) Seed sample data
python seed_apro_data.py

# Start the server
python manage.py runserver
# Backend runs on http://localhost:8000

Environment Variables (optional, for full features):

Set them in your terminal before running the server:

# Windows PowerShell
$env:HF_TOKEN="your_hf_token"
$env:EMAIL_HOST_USER="your@gmail.com"
$env:EMAIL_HOST_PASSWORD="your_app_password"

Open a new terminal:

cd client

# Install dependencies
npm install

# Start the development server
npm run dev
# Frontend runs on http://localhost:5173

• Hospital Registration & Authentication
• Real-Time Bed Tracking (ICU, General, NICU, Emergency)
• Blood Inventory Management
• Blood Donor Registration with Email Confirmation
• Ambulance Dispatch & Emergency Management
• RAG-Powered AI Chatbot
• AI Hospital Recommendation Engine
• Patient Portal & Review System
• Staff Portal with Batch Save
• Mobile App (React Native)
• Google Maps Integration for Live Tracking
• SMS Notifications for Emergencies
• Government Hospital API Integration
• Multi-language Support (Hindi, Tamil, etc.)
• Access the admin portal with
• user name-medgrid_admin
• password- AmishaPandey

We welcome contributions! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

This project is open source and available under the MIT License.

Made with ❤️ for better healthcare access

Team MedGrid — GitHub