pose-think / README.md
sems's picture
Upload 3 files
894cca2 verified

A newer version of the Gradio SDK is available: 5.36.2

Upgrade
metadata
title: Pose-Think AI Movement Analysis
emoji: 🎯
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 4.8.0
app_file: app.py
pinned: false
license: mit

🎯 Pose-Think: AI-Powered Movement Analysis Suite

Real-time posture and movement analysis with multiple specialized modes. Get instant feedback on what the camera sees!

🌟 Features

🎯 Basic Posture Analysis

  • Real-time body detection: Instantly identifies visible body parts
  • Joint angle measurements: Precise elbow, knee, and other joint angles
  • Posture alignment: Shoulder level, hip alignment, neck position
  • Clear feedback: "Left shoulder high", "Neck tilted right", "Elbows at 156Β°"

🎯 Enhanced Posture Analysis

  • Everything from Basic mode plus:
  • Age-specific recommendations: Tailored advice for different age groups
  • BMI calculation: Height/weight analysis for posture load assessment
  • Personalized insights: Context-aware health recommendations

🀚 Hand Tracking

  • Dual hand detection: Track up to 2 hands simultaneously
  • Finger counting: Automatic detection of extended fingers
  • Gesture analysis: Real-time hand position and orientation
  • Perfect for: Hand exercises, gesture recognition, rehabilitation

πŸš€ How to Use

  1. Choose Analysis Type: Select from Basic Posture, Enhanced Posture, or Hand Tracking
  2. Allow Camera Access: Grant permission when prompted by your browser
  3. Position Yourself:
    • For Posture: Stand 2-3 meters from camera, full body visible
    • For Hands: Show hands clearly to the camera
  4. Click Analyze: Get instant, detailed feedback
  5. Enhanced Mode: Optionally enter age/height/weight for personalized insights

πŸ“Š What You'll See

Basic/Enhanced Posture Analysis:

βœ… Visible: Head, Shoulders, Elbows, Hips, Knees

πŸ“ Left elbow angle: 156.3Β°
πŸ“ Right elbow angle: 162.1Β°

⚠️ Left shoulder higher
βœ… Hips level
πŸ” Neck: Tilted right

Enhanced Mode Additional Info:

πŸ‘€ Profile: Age: 32 | BMI: 26.1
⚠️ BMI slightly high - extra load on posture

🎯 Age-Specific Recommendations:
πŸ’‘ Middle age: Regular exercise important
πŸ’Ό Make workspace ergonomic

Hand Tracking:

βœ… 2 hands detected

πŸ–οΈ Hand 1: 5 fingers up
πŸ–οΈ Hand 2: 3 fingers up

🎯 Perfect For

  • Personal Health: Quick posture checks and movement awareness
  • Workplace Wellness: Ergonomic assessments and posture monitoring
  • Fitness & Rehabilitation: Exercise form checking and progress tracking
  • Education & Research: Movement analysis and biomechanics studies
  • Accessibility: Hand gesture recognition and interaction

πŸ”§ Technical Details

  • AI Model: MediaPipe Pose and Hands (Google)
  • Processing: Real-time analysis at 30+ FPS
  • Accuracy: 95%+ detection rate in good lighting
  • Privacy: All processing done locally, no data stored
  • Compatibility: Works on desktop, tablet, and mobile browsers

πŸ“ Tips for Best Results

For Posture Analysis:

  • Lighting: Ensure even, bright lighting
  • Background: Use plain, contrasting background
  • Distance: Stand 2-3 meters from camera
  • Position: Keep full body visible in frame

For Hand Tracking:

  • Visibility: Keep hands clearly visible
  • Contrast: Ensure hands contrast with background
  • Movement: Avoid rapid movements for better tracking
  • Lighting: Good lighting improves accuracy

πŸŽ“ Understanding the Feedback

Symbols:

  • βœ… Green checkmarks: Good alignment/posture
  • ⚠️ Warning signs: Issues detected that need attention
  • πŸ“ Measurements: Precise joint angles in degrees
  • πŸ” Position info: Head, neck, body position details
  • πŸ‘€ Profile info: Personal context and recommendations

Measurements:

  • Joint angles: 0-180Β° range, closer to 180Β° = straighter
  • Alignment: Compares left vs right side positioning
  • Visibility: Shows which body parts are clearly detected

πŸš€ Built With

  • MediaPipe: Google's ML framework for pose and hand detection
  • Gradio: Modern web interface for ML applications
  • OpenCV: Computer vision and image processing
  • NumPy: Numerical computations

πŸ“„ License

MIT License - feel free to use and modify for your projects!

🀝 Contributing

This is part of the Pose-Think project. Contributions welcome on GitHub!


⚠️ Disclaimer: This tool is for educational and wellness purposes only. It does not provide medical diagnosis. Consult healthcare professionals for medical concerns.