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