| 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 | |
| ```bash | |
| # 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](CLAUDE.md) for full architecture details. | |
| ## Model Budget | |
| ~18B params total (under 32B cap). See [MODEL_BUDGET.md](MODEL_BUDGET.md). | |
| ## License | |
| Built for the Build Small Hackathon (Backyard AI track). | |