A patient-centric medication adherence ecosystem that empowers patients by:
- Providing smart reminders for medication intake.
- Enabling seamless tracking of their progress.
- Delivering personalized motivation and support to ensure consistent medication adherence.
π» Developed by Gameis Alice Team from PICT College
- PRAJWAL CHINCHMALATPURE
- DURGESH KHADE
- PARAS THAKUR
- NEHA DIWAN
- π Authentication System: Secure phone-based OTP authentication
- π Medication Management: Create and track medicine courses with customizable schedules
- β° Smart Notifications: Automated reminders for medicine intake
- π Adherence Tracking: Visual matrix to track medication compliance over time
- π± Real-time Updates: WebSocket-based instant notifications and updates
- π² Medication Intake Confirmation: Interactive notifications and allow patients to confirm medication intake with a single press
- π Smart Reminders: Context-aware notifications that adjust timing based on user behavior patterns
- π¬ Intelligent AI Assistant: Intuitive AI-powered chat system that allows patients to effortlessly update meal times, medication schedules, and health routines with natural language commands
- π Progress Visualization: Interactive charts showing adherence trends and health improvements
- π Sync Across Devices: Seamless experience across mobile and pillbox
- Express Server: RESTful API endpoints for all app features
- MySQL Database: Stores user data, medication courses, and intake records
- WebSockets: Real-time communication for notifications and updates
- Cron Jobs: Scheduled tasks for medication reminders and daily quote refreshing
- Twilio Integration: SMS-based OTP verification and notifications
- Flutter: Cross-platform mobile application
- Modern UI/UX: Intuitive user interface for all features
- Local Storage: Caching for offline functionality
- Push Notifications: Real-time alerts for medication reminders
- IoT Integration: Support for smart medication pill box
- Adherence Monitoring: Integration with intake tracking sensors
The application uses a relational database with tables for:
- Users
- Authentication tokens
- Prescription images
- Medication courses
- Medicine course
- Medicine intake
- Daily motivational quotes
- Node.js (v14+)
- MySQL Server
- Twilio Account (for SMS features)
- Cloudinary Account (for media storage)
- Navigate to the Backend directory
- Install dependencies:
npm install
- Set up your environment variables in
.env
- Initialize the database using
main.sql
- Start the server:
npm start
- Navigate to the Frontend directory
- Install dependencies
- Configure the app to connect to your backend
- Run the development server
The mobile application provides:
- User-friendly medication tracking interface
- Reminders and notifications
- Medication adherence insights and analytics
- Quote of the Day: Daily motivational health quotes in the user's preferred language
- Visual Medication Adherence: Intuitive matrix display showing medication compliance
- Custom User Notes: Personal health notes for patients to track symptoms and progress
- Token-based authentication
- Secure OTP verification
- AI-powered health insight
- Integration with wearable health devices
- Expanded language support
HealthMobi is planning to transition to an open source model to foster innovation and collaboration in healthcare technology. Our mission is to make quality healthcare management accessible to everyone.
- Health Wearables: API hooks for smartwatches and fitness trackers
- EHR Systems: Integration with electronic health record systems
- Pharmacy Networks: Direct connection with medical systems
- Telehealth Platforms: API for video consultation integration
This project is licensed under the MIT License.
-
Frontend (Flutter):
- User interface for patients and doctors
- Handles authentication, medication tracking, chat, and notifications
- Communicates with backend via REST API and WebSocket
- Integrates with smart pillbox via Bluetooth/IoT
-
Backend (Node.js/Express):
- Exposes RESTful API endpoints for all app features
- Manages authentication, user roles, medication courses, and notifications
- Handles real-time updates via WebSocket
- Runs cron jobs for reminders and daily quotes
- Integrates with Twilio for SMS/OTP
- Interfaces with MySQL for persistent storage
-
AI Layer:
- AI Assistant Service: Natural language chat, health queries, and schedule updates
- Prescription Extraction Service: Extracts structured data from prescription images/voice
- Chroma Vector DB: Stores and retrieves vectorized data for semantic search
-
Embedded C (Smart Pillbox):
- Tracks physical medication intake events
- Syncs with mobile app via Bluetooth
- Sends intake confirmations to backend
-
Database:
- MySQL: Main relational DB for users, courses, intakes, etc.
- Chroma DB: Vector database for AI semantic search and prescription data
sequenceDiagram
participant User
participant Frontend
participant Backend
participant Twilio
participant DB
User->>Frontend: Enter phone number
Frontend->>Backend: Request OTP
Backend->>Twilio: Send OTP SMS
Twilio-->>User: Deliver OTP
User->>Frontend: Enter OTP
Frontend->>Backend: Verify OTP
Backend->>DB: Check/Store user
Backend-->>Frontend: Auth token
Frontend-->>User: Access granted
sequenceDiagram
participant User
participant Frontend
participant Backend
participant DB
User->>Frontend: Add new medication course
Frontend->>Backend: POST /courses
Backend->>DB: Store course
Backend-->>Frontend: Success/ID
Backend->>Cron: Schedule reminders
Cron->>Backend: Trigger reminder
Backend->>Frontend: Push/WebSocket notification
Frontend-->>User: Reminder shown
sequenceDiagram
participant User
participant Frontend
participant AI_Assistant
participant Prescription_Extractor
participant ChromaDB
User->>Frontend: Upload prescription/chat
Frontend->>AI_Assistant: Send message/image
AI_Assistant->>Prescription_Extractor: Extract data (if image)
Prescription_Extractor->>ChromaDB: Store/extract vectors
AI_Assistant-->>Frontend: Reply/structured data
Frontend-->>User: Show AI response
-
Medication Reminders:
- Cron jobs in backend schedule reminders based on userβs medication course.
- Reminders are sent via push notification (mobile) and/or SMS (Twilio).
- Intake confirmation updates adherence matrix in DB.
-
AI Assistant:
- Handles natural language queries (e.g., "Change my breakfast time to 8am").
- Can extract structured data from prescription images/voice using the extraction service.
- Uses Chroma DB for semantic search and context.
-
Doctor-Patient Communication:
- Real-time chat via WebSocket.
- Doctors can send prescriptions (text/image/voice) to patients.
-
Security:
- All sensitive operations require token-based authentication.
- OTP verification for login/registration.
- Role-based access for doctor/patient features.
See the README.md in each major subdirectory for deep dives into:
We welcome contributions from everyone! Please read our Contributing Guidelines to get started.
See the FAQ.md for setup help and troubleshooting.