---
title: SPORALIZE
emoji: 🏃
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: "5.9.1"
app_file: app.py
pinned: false
license: mit
---

# SPORALIZE — 3D Stereo Biomechanics Analysis

Upload two synchronized camera videos and your stereo calibration file.  
SPORALIZE runs **RTMPose Wholebody** (133 keypoints including full foot detail),  
triangulates the 3D skeleton, and produces an interactive biomechanics dashboard.

## Inputs
| File | Description |
|---|---|
| `cam0.mp4` | Primary camera video |
| `cam1.mp4` | Secondary camera video (synchronized) |
| `calib.pkl` | Hybrid stereo calibration pickle (K1/K2/R/T/R_world/origin/SCALE) |

## Outputs
- **Live frame preview** — both cameras with skeleton overlay, scrub with slider
- **Metrics dashboard** — active angle, foot orientation, knee/hip angles, torso pitch/roll, head angle
- **Head angle chart** — color-coded above/below configurable threshold
- **3D pose viewer** — interactive Plotly 3D skeleton with foot keypoints highlighted
- **SPORALIZE JSON** — downloadable, compatible with the full SPORALIZE React app

## Model
RTMPose-m Wholebody (133 keypoints) via [rtmlib](https://github.com/Tau-J/rtmlib).  
ONNX weights are downloaded automatically on first run (~40 MB).