Skip to content

README.md

Latest commit

 

History

History
97 lines (68 loc) · 3.72 KB

README.md

File metadata and controls

97 lines (68 loc) · 3.72 KB

🧠 Do I Need to Sleep/Rest? - Enhanced AI Health Monitor

Revolutionary face analysis app with real-time fatigue detection and health monitoring

🚀 Major Enhancements & Features

🔬 Advanced AI Face Analysis

  • Real-time face detection using TensorFlow.js with 468 facial landmarks
  • Eye Aspect Ratio (EAR) calculation for precise blink detection and fatigue assessment
  • Facial landmark analysis with medical-grade accuracy
  • Head pose estimation (pitch, yaw, roll) for posture-related fatigue
  • Skin condition analysis detecting pallor and under-eye darkness
  • Multi-frame video analysis for enhanced accuracy

📊 Comprehensive Health Metrics

  • Fatigue Scoring (0-100% with weighted algorithm)
  • Eye Strain Monitoring with progressive indicators
  • Blink Rate Analysis (normal: 15-20 blinks/minute)
  • Facial Tension Assessment across forehead, jaw, and mouth
  • Drowsiness Indicators (heavy eyelids, slow blinks, head dropping)
  • Trend Analysis tracking patterns over time

🎯 Smart AI Recommendations

  • Contextual suggestions based on real-time analysis
  • Critical fatigue alerts for immediate attention (>85% fatigue)
  • Progressive recommendations from eye breaks to power naps
  • Posture improvement guidance for workspace ergonomics

How It Works

  1. Quick Analysis: Record a brief video or enable live monitoring
  2. AI Processing: Advanced facial analysis using 468 landmark points
  3. Health Assessment: Comprehensive fatigue and wellness scoring
  4. Smart Recommendations: Personalized suggestions based on your state
  5. Trend Tracking: Monitor your energy patterns over time

Installation

# Clone the repository
git clone https://github.com/yourusername/do-i-need-to-rest.git

# Navigate to project directory
cd need-to-rest-check

# Install dependencies
npm install

# Start the development server
npm start

Who Built This Sleep Health Monitor App?

Pierre-Henry Soria, a super passionate engineer who loves automating content creation efficiently! Enthusiast of YouTube, AI, learning, and—of course—writing! Find me at pH7.me

Enjoying this project? Buy me a coffee (my go-to is an oat extra-hot flat white coffee).

Pierre-Henry Soria

@phenrysay YouTube Tech Videos pH-7 BlueSky

Tech Stack

  • React Native
  • Expo
  • TypeScript
  • React Navigation
  • Expo Camera
  • AsyncStorage for local data
  • React Native Chart Kit for visualizations

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Future Plans

  • Implement actual ML model for more accurate fatigue detection
  • Add notification system for scheduled rest checks
  • Integrate with health apps
  • Add more detailed analysis reports

License

Do I Need To Rest is generously distributed under the MIT License.