---
title: PostureCoach — Real-Time Posture Analysis
emoji: 🧘
colorFrom: indigo
colorTo: purple
sdk: static
pinned: false
license: mit
short_description: Posture classifier with MediaPipe + AI coaching
---

# 🧘 PostureCoach — Real-Time Posture Analysis

A browser-based posture monitoring app that uses **MediaPipe Pose** to classify your posture in real time and provides **AI-powered coaching** via Hugging Face Inference API.

## Features

- 📷 **Real-time camera analysis** — MediaPipe detects 33 body landmarks and measures shoulder, neck, and torso angles
- ✅ **Good Posture vs Slouching classification** — instant visual feedback with color-coded skeleton overlay
- 📊 **Live dashboard** — tracks good/bad frame counts, session time, alert streaks, and angle sparkline
- 🔔 **Smart alerts** — configurable sound alarm + browser notifications when bad posture is detected
- 🤖 **AI Coach** — 10 LLM models via Hugging Face Inference API (Llama, Mistral, Phi-3, Gemma, Qwen)

## How to Use

1. Open the Space in your browser
2. Click **▶ Start Camera** and allow camera access
3. Sit in frame — posture analysis starts immediately
4. Switch to the **AI Coach** tab, paste your HF token, pick a model, and get personalized advice

## AI Models Supported

| Provider | Models |
|----------|--------|
| Meta | Llama 3.2 3B, Llama 3.1 8B |
| Mistral | Mistral 7B, Mixtral 8x7B |
| Microsoft | Phi-3 Mini, Phi-3.5 Mini |
| Google | Gemma 2 2B, Gemma 2 9B |
| Qwen | Qwen2.5 3B, Qwen2.5 7B |

> ⚠️ **AI Disclaimer**: Recommendations are generated by AI and are not a substitute for professional medical advice.

## Privacy

All posture analysis runs **100% in your browser** — no video is sent to any server. Your HF token is used only for direct API calls to Hugging Face from your browser.