metadata
title: FormScout
emoji: 🏔️
colorFrom: green
colorTo: green
sdk: gradio
app_file: app.py
pinned: false
license: apache-2.0
short_description: FMS video scoring — movement screen aid
FormScout
FMS (Functional Movement Screen) scoring pipeline — a screening aid that scores movement videos 0–3 per test with a written rationale and annotated overlay.
⚠️ Screening aid — not a diagnosis. Pain or clearing tests require a clinician.
Quick Start
# Install dependencies
pip install -r requirements.txt
# Run headless on a video
python -m formscout.run sample.mp4
# Launch Gradio app
python app.py
# Run tests
pytest tests/ -v
Architecture
Typed specialist agents orchestrated by a deterministic Director:
Ingest → Pose2D → [Body3D optional] → Biomechanics → Rubric Score → [Judge] → Report
See CLAUDE.md for full architecture details.
Model Budget
~18B params total (under 32B cap). See MODEL_BUDGET.md.
License
Built for the Build Small Hackathon (Backyard AI track).