sports-video-coach

Turn your coding agent into your sports coach.

Open-source sports video analysis for adults who train on their own: film a session or a game on your phone (basketball, running, the gym ...), and your coding agent gives you a coaching page, clips, drills and an explained video.

Start in one prompt

Film your run, gym or HYROX session, soccer match or basketball practice on your phone, then paste this into Claude Code, Codex or another coding agent:

Coach me on my sports video: <path to your video>
Clone https://github.com/mariusDing/sports-video-coach and follow its START.md.

中文提示词

帮我分析我的运动视频：<视频路径>
克隆 https://github.com/mariusDing/sports-video-coach ，按里面的 START.md 一步步做。

Your agent clones the repo, shows you the install commands and waits for your OK, asks what the video cannot tell it, then runs the review until your coaching page and explained video are ready.

What it follows: START.md

☆ Star on GitHub If it helped, a star is how I know.

A real training review in 43 seconds

Original footage, freeze-frame cues, two selected attempts, and a next-practice suggestion. This agent-reviewed example is edited for length; it does not measure improvement or shooting accuracy.

Explore a complete coaching-page demo

Athletes

One session in: what to fix, one drill, a check for next time.

Coaches

A team report and focus-player deep dive, with clips, audio and optional unlisted sharing links.

Developers

A resumable CLI that pauses (exit 3) whenever it needs the agent's eyes or words, with a validator per agent step. A new sport plugin is one command.

Open the demo coaching page Get it on GitHub

From game film to the next practice

Watch, read or listen

Timestamped reviews, mobile reports, source clips and narrated MP4s. Generic reports support eight languages; basketball supports English and Chinese.

Basketball game analysis

Player and ball tracking, shot charts, league statistics, Four Factors, possessions and lineups. Measurements and reviewed evidence support team and player coaching.

Practice and prepare

Personal shooting sessions, movement review, training plans, cue audio, opponent scouting, season summaries, tactics replays and phone reels.

Built for coding agents

Claude Code, Codex and other agents use JSON artifacts, writing guides and explicit exit codes. Resume completed stages or extend the workflow with a sport plugin.

OpenHoopVision evidence

Optional shot, pass, dribble, rebound and possession-change candidates, plus pose and jersey evidence. Review decisions and source clips keep automatic suggestions inspectable.

Vision experiments you can check

Compare WASB ball heatmaps, SAHI sliced detection and KaliCalib court proposals against independent labels. Interactive HTML and comparison videos expose misses, false positives and cost.

Choose the depth you need. Generic film review needs no GPU. Basketball vision needs its tracking dependencies and usable footage. WASB, SAHI and KaliCalib are opt-in experiments, with mixed results in the first diagnostic; they do not automatically replace official stats or reviewed calibration. Read the measured results and limitations.

Vision runs locally. Frames your agent views go to its model provider; narration uses online text-to-speech. Publishing is optional. Privacy and sharing.

Try it (needs ffmpeg)

uv tool install git+https://github.com/mariusDing/sports-video-coach@74b517fc410944fefeac2979810656ed77fb8f1a
sports-video-coach demo

Your sport needs more than frames? Write a plugin for your sport.

Which coding agent reviews sports film best? See the benchmark leaderboard.

The coaching-page demo is synthetic: a drawn drill video (a red block between two cones) and a pre-written review, so no person appears. Other languages: film.zh.mp4 Built from master (0.3.1.dev0, not released yet).