How mariuscnn/sports-video-coach works
sports-video-coach is a local, agent-assisted sports-film coaching tool, not a hosted app. A user supplies video and coaching context; the resumable CLI prepares review material, pauses for the agent’s observations and words, then produces a multilingual coaching page, spoken report and explained video. Generic review, fitness analysis and basketball game review are distinct product paths. The README documents these capabilities; sampled excerpts expose core orchestration and fitness validation, while basketball implementation details are only partly sampled, so uncertain internal links are omitted.
Main entry points: pipeline.py Resumable pipeline · coach_review.py Basketball review · unit.py Fitness session · film.py Explained video
Components 27
Core coaching workflow
- CLI
src/sports_video_coach/cli.py - Resumable pipeline
src/sports_video_coach/pipeline.py - Sport plugins
src/sports_video_coach/plugin.py - Media tools
src/sports_video_coach/media.py
Generic coaching outputs
- Generic review
src/sports_video_coach/plugins/generic/unit.py - Clip extraction
src/sports_video_coach/clips.py - Evidence lessons
src/sports_video_coach/lessons.py - Report narration
src/sports_video_coach/narrate.py - Explained video
src/sports_video_coach/film.py - Coaching page
src/sports_video_coach/render_html.py - Language registry
src/sports_video_coach/langs.py
Fitness plugin
- Fitness plugin
src/svc_fitness/plugin.py - Fitness session
src/svc_fitness/unit.py - Exercise library
src/svc_fitness/library.py - Pose analysis
src/svc_fitness/pose.py - Rep metrics
src/svc_fitness/reps.py - Fitness report page
src/svc_fitness/page.py
Basketball review
- Basketball review
src/hoop_tape_miner/coach_review.py - Coach evaluation
src/hoop_tape_miner/coach_eval.py - Review schema
src/hoop_tape_miner/coach_schema.py - Review progress
src/hoop_tape_miner/review_progress.py - Court model
src/hoop_tape_miner/court.py - Possession analysis
src/hoop_tape_miner/possessions.py - Team and player pages
src/hoop_tape_miner/coach_summary.py - Basketball analytics
src/hoop_tape_miner/coach_insights.py
Other components
- Player or coach
- Coaching deliverables
Connections 32
- Player or coach → CLI: submits video
- CLI → Resumable pipeline: starts run
src/sports_video_coach/pipeline.py - Resumable pipeline → Sport plugins: loads plugin
src/sports_video_coach/pipeline.py - Resumable pipeline → Media tools: uses media tools
src/sports_video_coach/pipeline.py - Resumable pipeline → Generic review: runs stages
src/sports_video_coach/pipeline.py - Resumable pipeline → Clip extraction: runs clips stage
src/sports_video_coach/pipeline.py - Resumable pipeline → Report narration: runs narration
src/sports_video_coach/pipeline.py - Resumable pipeline → Explained video: runs film stage
src/sports_video_coach/pipeline.py - Resumable pipeline → Coaching page: renders page
src/sports_video_coach/pipeline.py - Explained video → Clip extraction: uses clips
src/sports_video_coach/film.py - Explained video → Media tools: processes video
src/sports_video_coach/film.py - Explained video → Report narration: uses narration
src/sports_video_coach/film.py - Coaching page → Clip extraction: renders clip markers
src/sports_video_coach/render_html.py - Coaching page → Language registry: localizes page
src/sports_video_coach/render_html.py - Resumable pipeline → Evidence lessons: uses lessons
src/sports_video_coach/pipeline.py - Resumable pipeline → Coaching deliverables: produces reports
- Player or coach → Fitness plugin: chooses fitness
- Fitness plugin → Fitness session: provides session unit
src/svc_fitness/plugin.py - Fitness session → Exercise library: validates exercises
src/svc_fitness/unit.py - Fitness session → Pose analysis: runs pose stage
src/svc_fitness/unit.py - Fitness session → Rep metrics: runs rep stage
src/svc_fitness/unit.py - Fitness session → Fitness report page: uses report page
src/svc_fitness/unit.py - Fitness plugin → Coaching deliverables: adds strength metrics
- Player or coach → Basketball review: chooses basketball
- Basketball review → Coach evaluation: uses evaluation
src/hoop_tape_miner/coach_review.py - Basketball review → Review schema: checks review data
src/hoop_tape_miner/coach_review.py - Basketball review → Review progress: tracks sheet coverage
src/hoop_tape_miner/coach_review.py - Basketball review → Court model: uses court model
src/hoop_tape_miner/coach_review.py - Basketball review → Possession analysis: uses possessions
- Basketball review → Team and player pages: builds team pages
- Basketball review → Basketball analytics: summarizes coaching insights
- Basketball review → Coaching deliverables: produces game review