TeleMed AI - Comprehensive Telemedicine Platform

A modern, AI-powered telemedicine platform built with React, TypeScript, and Node.js. Featuring intelligent medical assistance, document analysis, voice interaction, and automated appointment scheduling.

🚀 Features

Core Functionality

• AI Medical Assistant: Powered by Google's Gemini API for intelligent health guidance
• Document Analysis: Upload and analyze medical reports with AI insights
• Voice Interaction: Speech-to-text input and text-to-speech responses
• Smart Scheduling: Automated appointment booking with email confirmations
• Multi-role Support: Separate interfaces for patients and healthcare providers

Advanced Features

• Responsive Design: Mobile-first approach with seamless desktop experience
• Accessibility: WCAG 2.1 AA compliant with screen reader support
• Real-time Chat: Smooth conversational interface with message history
• File Upload: Support for PDFs, images, and text documents
• Health Dashboard: Comprehensive patient health tracking and insights

🛠 Technology Stack

Frontend

• React 18 with TypeScript
• Tailwind CSS for styling
• Framer Motion for animations
• React Router for navigation
• Lucide React for icons

Backend

• Node.js with Express
• Nodemailer for email services
• Multer for file uploads
• Google Generative AI (Gemini)

APIs & Services

• Gemini API for AI responses
• Web Speech API for voice interaction
• FileReader API for document processing

📦 Installation

1. Clone the repository

   git clone <repository-url>
   cd telemed-ai-platform

2. Install dependencies

   npm install

3. Set up environment variables

   cp .env.example .env

   Edit .env with your actual configuration:

   • GEMINI_API_KEY: Your Google Gemini API key
   • SMTP_*: Email service configuration
   • Other required environment variables

4. Start development servers

   # Frontend only
   npm run dev
   
   # Frontend + Backend
   npm run dev:full

🔧 Configuration

Gemini API Setup

1. Visit Google AI Studio
2. Create a new API key
3. Add it to your .env file as both GEMINI_API_KEY and VITE_GEMINI_API_KEY

Important: The frontend uses VITE_GEMINI_API_KEY for direct API calls. In production, move all API calls to the backend for security.

Email Service Setup

Configure your SMTP settings in .env:

SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=your_email@gmail.com
SMTP_PASS=your_app_password

For Gmail, you'll need to:

1. Enable 2-factor authentication
2. Generate an app-specific password
3. Use the app password in SMTP_PASS

🏗 Project Structure

src/
├── components/
│   ├── auth/           # Authentication components
│   ├── chatbot/        # AI chatbot interface
│   ├── docs/           # Documentation pages
│   ├── home/           # Landing page
│   ├── layout/         # Navigation and layout
│   └── profile/        # User dashboard
├── contexts/           # React contexts (Auth, etc.)
├── services/           # API services
├── types/              # TypeScript type definitions
└── App.tsx            # Main application component

server/
├── api/               # Backend API endpoints
│   ├── gemini.js      # Gemini AI integration
│   └── email.js       # Email service
└── server.js          # Main server file

🎯 Usage

For Patients

1. Sign up/Login as a patient
2. Chat with AI: Ask health questions, get guidance
3. Upload Documents: Medical reports for AI analysis
4. Schedule Appointments: Book consultations
5. Track Health: View dashboard with health insights

For Healthcare Providers

1. Login as a doctor
2. Patient Management: Access patient reports and data
3. Appointment Management: View and manage appointments
4. Document Review: Annotate and review patient documents

🔒 Security & Privacy

• End-to-end encryption for data transmission
• HIPAA-compliant data handling
• Secure file storage with access controls
• Privacy-first design with user consent management

🌐 Browser Compatibility

• Chrome 90+
• Firefox 88+
• Safari 14+
• Edge 90+

Voice features require modern browser support for Web Speech API.

🚀 Deployment

Production Build

npm run build

Environment Setup

Ensure all production environment variables are configured:

• Database connections
• API keys
• SMTP settings
• Security configurations

Docker Deployment

# Example Dockerfile
FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
RUN npm run build
EXPOSE 3001
CMD ["npm", "start"]

📱 Mobile Responsiveness

The platform is fully responsive with:

• Mobile-first CSS approach
• Touch-friendly interface elements
• Optimized layouts for all screen sizes
• Progressive Web App capabilities

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

📄 License

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

🆘 Support

For support and questions:

• Check the documentation in the /docs section
• Create an issue on GitHub
• Contact: support@telemed.com

🔄 Version History

• v1.0.0: Initial release with core features
• v1.1.0: Enhanced voice interaction
• v1.2.0: Advanced document analysis
• v1.3.0: Multi-role support

---

Built with ❤️ for better healthcare accessibility