README.md

---
title: MediaPipe Pose Estimation
short_description: Track 33 body keypoints using MediaPipe
emoji: 🧍
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
---

# MediaPipe Pose Estimation

Professional pose detection and visualization system powered by Google MediaPipe. Track 33 body keypoints with customizable visualization options.

## Features

- Real-time pose estimation with 33 anatomical keypoints
- Adjustable detection and tracking confidence thresholds
- Black background or original video overlay options
- Single color or multicolor body part visualization
- Professional-grade output with H.264 encoding

## Quick Start

1. Upload a video file (MP4, AVI, MOV, WebM)
2. Adjust confidence parameters (default: 0.5 recommended)
3. Select background type and color mode
4. Process video

## Parameters

**Detection Confidence** (0.0-1.0)  
Controls pose detection sensitivity. Higher values reduce false positives.

**Tracking Confidence** (0.0-1.0)  
Determines tracking stability across frames. Higher values provide more stable tracking.

## Color Modes

**Single Color**: Uniform skeleton visualization with customizable colors

**Multicolor**: Body parts colored by region
- Torso: Yellow
- Right Arm: Red | Left Arm: Blue  
- Right Leg: Magenta | Left Leg: Green

## Output

- Format: MP4 (H.264)
- Resolution and frame rate match input
- Processing time scales with video length and resolution

## Technical Stack

MediaPipe Pose Landmarker | OpenCV | Gradio | Python

---

**Note**: Videos exceeding 2 minutes or high resolution may require extended processing time.