A comprehensive, privacy-first AI-powered medical assistant built with Next.js, React, and Google Gemini AI. This application provides professional medical guidance, symptom assessment, emergency triage, test result analysis, appointment booking, and family health management in multiple languages.

• User Registration - Complete signup form with validation
• User Login - Secure authentication with demo credentials
• Demo Accounts - Pre-configured accounts for testing
• Route Protection - Automatic redirect for unauthenticated users
• Session Management - Persistent login state
• Logout Functionality - Secure session termination

• Google Gemini AI Integration - Advanced medical reasoning and analysis
• Multilingual Support - 4 languages: English, Hindi, Spanish, French
• Multiple Consultation Modes:
  • General Medical Consultation
  • Symptom Triage Assessment
  • Emergency Medical Guidance
  • Second Opinion Consultation
• Real-time Chat Interface - Stream-based responses for instant feedback
• Medical Context Awareness - Tailored responses based on consultation type

• Multi-language Voice Synthesis - Native voices for each supported language
• Speech-to-Text - Voice input with language detection
• Text-to-Speech - AI responses spoken in selected language
• Voice Speed Control - Optimized speech rates for each language
• Voice Interruption - Stop speech with keyboard shortcuts (Space/Escape)
• Automatic Voice Selection - Smart voice mapping for each language

• File Upload Support - PDF, JPG, PNG, TXT formats (up to 10MB)
• AI-Powered Analysis - Automatic value extraction from lab reports
• Reference Range Comparison - Normal vs. abnormal result identification
• Risk Assessment - Overall health status and urgency evaluation
• Personalized Recommendations - Actionable health advice
• Manual Entry Mode - Add test results manually for analysis
• Sample Data Analysis - Demo with realistic medical data

• GPS Location Detection - Automatic location services
• Nearby Hospital Finder - Real-time hospital location mapping
• Emergency Contact Integration - Quick access to emergency numbers
• Emergency Triage - Immediate threat assessment
• Critical Action Guidance - Step-by-step emergency instructions
• Location-based Services - Country-specific emergency protocols

• Smart Date Validation - Prevents past date selection
• Phone Number Validation - Format verification for different countries
• Appointment Categories - Specialized booking for different medical needs
• Time Slot Management - Available appointment time selection
• Booking Confirmation - Email/SMS confirmation system
• Calendar Integration - Sync with personal calendar

• Family Member Profiles - Individual health records for family members
• Age-based Recommendations - Tailored advice for different age groups
• Family Health Dashboard - Overview of family health status
• Shared Health Records - Family health history tracking
• Pediatric Guidance - Specialized advice for children
• Elderly Care Support - Senior-specific health recommendations

• Secure File Upload - Medical document storage
• Document Organization - Categorized health records
• Search and Filter - Easy record retrieval
• Privacy Protection - Local storage with encryption
• Export Functionality - Download health records
• Record Sharing - Secure sharing with healthcare providers

• Medication Tracking - Dosage and schedule management
• Reminder System - Medication reminder notifications
• Drug Interaction Check - Safety verification
• Side Effect Monitoring - Adverse reaction tracking
• Refill Reminders - Prescription renewal alerts
• Medication History - Complete medication timeline

• Dark/Light Theme Toggle - User preference with smooth transitions
• Responsive Design - Optimized for desktop, tablet, and mobile
• Accessibility Features - WCAG compliant interface
• Modern UI Components - Beautiful, intuitive design
• Loading States - Smooth user feedback
• Error Handling - Graceful error recovery
• Offline Support - Basic functionality without internet

• TypeScript - Type-safe development
• Next.js 14 - Latest React framework with App Router
• Tailwind CSS - Utility-first styling
• Radix UI - Accessible component library
• Real-time Updates - Live data synchronization
• Progressive Web App - Installable web application
• SEO Optimized - Search engine friendly

• Node.js 18+
• npm or pnpm
• Google Gemini AI API key

git clone <repository-url>
cd ai-doctor-assistant
npm install

Create .env.local:

GOOGLE_GENERATIVE_AI_API_KEY=your_api_key_here
DEBUG=false

1. Visit Google AI Studio
2. Create API key
3. Add to .env.local

npm run dev

Open http://localhost:3000

1. Visit /login or /signup
2. Use demo credentials or create new account
3. Access protected features after authentication

1. Navigate to "AI Consultation"
2. Select consultation mode (General/Triage/Emergency)
3. Choose language preference
4. Enable voice features if desired
5. Start chatting with AI medical assistant

1. Go to "Test Results"
2. Upload medical reports or enter manually
3. AI analyzes and provides insights
4. Review recommendations and risk assessment

1. Access "Emergency" page
2. Allow location access for nearby hospitals
3. Get immediate medical guidance
4. Contact emergency services if needed

1. Visit "Appointments"
2. Select appointment type and date
3. Enter contact information
4. Confirm booking

1. Access "Family Health"
2. Add family member profiles
3. Track individual health records
4. Get age-appropriate recommendations

ai-doctor-assistant/
├── app/                          # Next.js app directory
│   ├── api/                     # API routes
│   │   ├── chat/               # AI consultation API
│   │   ├── analyze-test-results/ # Test analysis API
│   │   ├── book-appointment/   # Appointment booking API
│   │   ├── emergency-location/ # Location services API
│   │   ├── triage-assessment/  # Triage API
│   │   ├── upload-records/     # Health records API
│   │   └── stream-chat/        # Streaming chat API
│   ├── login/                  # Authentication pages
│   ├── signup/                 # User registration
│   ├── chat/                   # AI consultation page
│   ├── triage/                 # Symptom triage page
│   ├── test-results/           # Test analysis page
│   ├── emergency/              # Emergency services page
│   ├── appointments/           # Appointment booking page
│   ├── family/                 # Family health page
│   ├── records/                # Health records page
│   ├── medications/            # Medication management page
│   └── settings/               # User settings page
├── components/                  # React components
│   ├── ui/                     # UI component library
│   ├── auth-guard.tsx          # Route protection
│   ├── app-sidebar.tsx         # Main navigation sidebar
│   ├── top-navigation.tsx      # Top navigation bar
│   ├── theme-provider.tsx      # Dark/light theme provider
│   ├── medical-translator.tsx  # Language translation
│   ├── emergency-modal.tsx     # Emergency modal
│   └── medical-disclaimer.tsx  # Medical disclaimers
├── lib/                        # Utility functions
│   ├── utils.ts               # General utilities
│   └── voice-manager.ts       # Voice management system
├── hooks/                      # Custom React hooks
├── public/                     # Static assets
└── styles/                     # Global styles

npm run dev          # Start development server
npm run build        # Build for production
npm run start        # Start production server
npm run lint         # Run ESLint
npm run type-check   # TypeScript type checking

⚠️ Important: This application is for educational and informational purposes only.

• Not a replacement for professional medical advice
• Not for diagnosis or treatment decisions
• Always consult qualified healthcare providers

• India: Call 108 or 102
• United States: Call 911
• Europe: Call 112
• Visit nearest emergency room immediately

• AI provides educational guidance only
• For diagnosis/treatment, consult licensed providers
• Use as supplementary information source

This project is licensed under the MIT License - see the LICENSE file for details.

• Issues: GitHub Issues
• Documentation: Check the /docs folder for detailed guides
• Medical Questions: Consult healthcare professionals

• Telemedicine Integration - Video consultation capabilities
• Wearable Device Sync - Health tracker integration
• Health Analytics - Trend analysis and insights
• Multi-language Expansion - Additional language support
• Two-Factor Authentication - Enhanced security
• Social Login - Google, Facebook, Apple integration

Built with ❤️ for better healthcare accessibility

This application prioritizes user privacy and data security while providing valuable health information and guidance.