README.md

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).