MedicSense AI - Complete Healthcare Assistant 🏥

A comprehensive AI-powered medical chatbot with symptom analysis, emergency detection, appointment scheduling, and health record management.

• ✅ AI Medical Chatbot - Natural language symptom analysis
• ✅ Emergency Detection - Instant first-aid guidance for critical situations
• ✅ Severity Classification - 4-level urgency system (Mild to Critical)
• ✅ Doctor Matching - Find specialists based on symptoms
• ✅ Appointment Scheduling - Book and manage appointments
• ✅ Health Records - Track vitals, symptoms, and medical history
• ✅ Image Analysis - Analyze injury/medical images
• ✅ Family Doctor System - Save and consult family physician
• ✅ Real-time Chat - LLM-style conversational interface

• 📊 Health Dashboard - Visualize health trends
• 🔔 Smart Notifications - Appointment reminders and health alerts
• 📱 Responsive Design - Works on all devices
• 🌐 Multi-language Support - (Coming soon)
• 🔒 Data Privacy - Local storage, HIPAA-compliant ready

medisence-ai/
├── backend/                    # Flask backend server
│   ├── app.py                 # Main Flask application
│   ├── database.py            # Database management
│   ├── auth_manager.py        # Authentication & sessions
│   ├── symptom_analyzer.py    # Symptom extraction
│   ├── severity_classifier.py # Urgency classification
│   ├── emergency_detector.py  # Emergency detection
│   ├── camera_analyzer.py     # Image analysis
│   ├── gemini_service.py      # AI integration
│   ├── otp_service.py         # OTP management
│   ├── medical_kb.json        # Medical knowledge base
│   ├── doctors_db.json        # Doctors database
│   └── requirements.txt       # Python dependencies
│
├── frontend/                   # Frontend application
│   ├── index.html             # Main page
│   ├── script.js              # Core JavaScript
│   ├── dashboard.js           # Dashboard functionality
│   ├── style.css              # Styles
│   └── auth.html              # Authentication page
│
├── API_DOCUMENTATION.md        # Complete API docs
└── README.md                   # This file

• Python 3.8 or higher
• Modern web browser
• VS Code (recommended)

git clone https://github.com/Shivansh1146/MedicSense-AI

cd backend
pip install -r requirements.txt

Dependencies installed:

• Flask 2.3.3 - Web framework
• flask-cors 4.0.0 - Cross-origin support
• Pillow 10.1.0 - Image processing

python app.py

You should see:

🚀 MedicSense AI Backend Starting...
📡 Server running at http://localhost:5000
💊 Medical chatbot ready to assist

Open your browser and go to:

http://localhost:5000

• Click the chat icon in the bottom-right corner
• Describe your symptoms naturally
• Get instant AI-powered analysis

"I have a severe headache and fever"
"My chest hurts and I feel dizzy"
"I twisted my ankle while playing"
"I need a doctor for heart problems"

The system automatically detects emergencies and provides first-aid guidance:

• Chest pain
• Severe bleeding
• Difficulty breathing
• Loss of consciousness

• Save your family doctor
• Book appointments with specialists
• Manage and reschedule appointments

• Record vital signs
• Monitor health trends
• Store medical history

• POST /api/chat - Chat with AI
• POST /api/auth/otp/send - Send OTP
• POST /api/auth/otp/verify - Verify OTP
• POST /api/appointments/book - Book appointment
• GET /api/appointments/<user_id> - Get appointments
• POST /api/health/vitals - Save vital signs
• GET /api/health/vitals/<user_id> - Get health records
• POST /api/analyze-injury-image - Analyze images
• GET /api/find-doctors - Search doctors

See API_DOCUMENTATION.md for complete API reference.

1. Get a free API key from Google AI Studio
2. Create .env file in backend folder:

GEMINI_API_KEY=your_api_key_here

3. Restart the server

Edit backend/medical_kb.json to add:

• New symptoms
• Medical conditions
• Treatment recommendations

Edit backend/doctors_db.json to add local doctors and hospitals.

• ✅ Session token management
• ✅ Local data storage
• ✅ CORS protection
• ✅ Input sanitization
• ✅ Secure file uploads

# In backend folder
python test_api.py

Send messages with emergency keywords:

• "chest pain"
• "can't breathe"
• "severe bleeding"

heroku create medisense-ai
git push heroku main

1. Connect your GitHub repository
2. Deploy from main branch
3. Set environment variables

See deployment guides in docs/ folder.

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

This project is licensed under the MIT License.

Shivansh

• GitHub: @Shivansh1146

• Flask framework
• Google Gemini AI
• Medical knowledge databases
• Open-source community

For issues and questions:

• Open an issue on GitHub
• Email: [email protected]

• Multi-language support
• Prescription management
• Lab report analysis
• Medicine reminders
• Telemedicine integration
• Insurance integration
• Mobile app (React Native)

MedicSense AI is an educational tool and should not replace professional medical advice.

Always consult with qualified healthcare professionals for medical concerns. In emergencies, call your local emergency number (911 in the US).

Made with ❤️ for better healthcare access

Star ⭐ this repository if you find it helpful!