Docs

Run it. Watch it. Verify it.

Only the useful surfaces: public demo, local run command, results page, and repo docs.

Watch

Open demo videos with public-safe volleyball clips.

Run

Install locally, start the Mac server, scan from phone.

Verify

Read results: run metrics, positioning, and demo-ready outputs.

Inspect

Open GitHub for source, tests, and issues.

Local start

One Mac. One command path.

git clone https://github.com/jravinder/refereai-mlx
cd refereai-mlx
bash scripts/bootstrap.sh
.venv/bin/refereai serve --port 8765

The local server prints phone URLs and serves the HIL Review console. Public Vercel pages do not serve private debug artifacts.

Repo reads

Open these if you need detail.

READMEREADME.md
Product overview, architecture, privacy boundary, and local run path.
InterfacesINTERFACES.md
Module contracts for tracking, classifier verdicts, sport plugins, and WebSocket payloads.
SecuritySECURITY.md
What stays private, what is safe to publish, and what to do if private media leaks.