Home/Computer Vision/AI-Basketball-Referee
AI-Basketball-Referee logo

AI-Basketball-Referee

ayushpai/AI-Basketball-Referee

AI Basketball Referee

GraphCanon updated 3w · GitHub synced 3w

360 stars69 forksLast push 2y Python

Decision brief

AI-Basketball-Referee is a computer vision system that uses YOLO for basketball detection and pose estimation to improve referee accuracy in real-time by detecting travels and double dribbles with precision.

Good fit when

  • When needing precise and automated travel and double dribble detections during live games to enhance fairness.
  • For collecting comprehensive data on player movements and ball interactions to refine machine learning models and statistics.

Avoid when

  • If the system needs to run without real-time feedback capabilities, as AI-Basketball-Referee heavily relies on providing immediate detection of violations during gameplay.
  • In scenarios prioritizing low-cost solutions, given its dependency on a custom YOLO model and extensive labeled data set for accurate detections.

Observed Jul 12, 2026 · Source: enrich:decision_facts

Verify the decision

Maintenance and security

Full trust report
Maintenance
Dormant (838d since push)
As of 3w
Provenance
Not a fork · Personal account
As of 3w
Security (OSV)
No lockfile
As of 1mo

Public GitHub metadata and optional OSV scans. Signals, not a guarantee. Trust methodology.

Install

pip install AI-Basketball-Referee
PyPI

Similar tools

Same-category neighbours. No typed graph edges are catalogued for this tool yet.

Evidence and technical details

Sourced facts, taxonomy, compatibility claims, README excerpt, and machine-readable endpoints.

Overview

A computer vision-based system using YOLO for basketball detection and pose estimation to improve referee accuracy in basketball games.

Capability facts

Languages
python

Source: github.language · Aug 1, 2026

Categories

Tags

README

AI Basketball Referee v2.0

Demo Video

Purpose

Sports are evolving day by day and the technology that supports these sports are evolving at an exponential rate. Many sports have implemented computer vision in order to improve referee calls and the overall fairness of the game. Tennis uses cameras to detect if a ball is out, Track and Field use cameras to detect who won a race, and many more. One sport however that has failed to do so on a significant scale is basketball. On top of that, basketball is one of the sports that is notorious for championship-changing, egregious referee calls. Implementing computer vision to watch over basketball games can not only make the game a much more fair experience for players and fans but also be a way of collecting data to use for greater machine learning models and statistics.

How it works

The AI Basketball Referee is a computer vision-based system that uses a custom YOLO (You Only Look Once) machine learning model trained on 3000 annotated images to detect basketballs in real-time. Additionally, it utilizes YOLO pose estimation to detect keypoints on the body of the players. By combining these two techniques, the AI Basketball Referee is capable of accurately identifying travels and double dribbles in basketball games.

Basketball Detection

The first step in the AI Basketball Referee's process is basketball detection. The YOLO machine learning model is trained to recognize basketballs within the video frames. It has been trained on a diverse dataset of 3000 annotated images containing various basketball poses, lighting conditions, and backgrounds. During runtime, the model analyzes each frame in real-time and predicts bounding boxes around the detected basketballs.

Pose Estimation

To enable the detection of travels and double dribbles, the AI Basketball Referee also employs YOLO pose estimation. This technique allows the system to identify and track keypoints on the body of the players. Key body joints such as the ankles, knees, hips, elbows, and wrists are crucial for determining player movements accurately.

Travel Detection

Once the basketballs and player keypoints are detected, the AI Basketball Referee applies a set of predefined rules to determine if a travel violation has occurred. By analyzing the position and movement of the player's keypoints over consecutive frames, the system can detect instances where a player has taken steps without dribbling the ball or has moved more than the allowed distance without dribbling or passing.

Double Dribble Detection

Similarly, the AI Basketball Referee leverages the detected basketballs and player keypoints to identify double dribbles. By tracking the position and movement of the player's keypoints and analyzing the interactions with the basketball, the system can detect situations where a player dribbles the ball, stops, and then starts dribbling again without another player touching or possessing the ball in the meantime.

Real-time Feedback

The AI Basketball Referee provides real-time feedback on travel and double dribble violations during basketball games. It highlights the detected violations on the video feed, making it easy for referees or users to identify and assess the accuracy of the system's decisions. Additionally, the system can generate logs or alerts to record detected violations for further analysis or review.

Customizability and Expansion

The AI Basketball Referee has been designed to be customizable and expandable. Users can fine-tune the system's parameters, such as the detection threshold for basketballs and the sensitivity of travel and double dribble detection, to suit their specific requirements. Furthermore, additional rules and detection capabilities can be incorporated into the system to address other basketball violations or game situations.

Overall, the AI Basketball Referee combines state-of-the-art computer vision techniques, including YOLO object detection and pose estimatio

For agents

This page has a .md twin and JSON over the API.

Was this helpful?

Anonymous feedback helps us improve pages and translations.