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

AI-Basketball-Referee

ayushpai/AI-Basketball-Referee

AI Basketball Referee

GraphCanon updated today · GitHub synced today

359
Stars
68
Forks
1
Open issues
9
Watchers
2y
Last push
PythonCreated Jul 30, 2022

Trust & integrity

Full report
Maintenance
Dormant (817d since push)
As of today · Source: github_public_v1
Provenance
Not a fork · Personal account
As of today · Source: github_public_v1
Security (OSV)
No lockfile
As of today · Source: none

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

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 · Jul 12, 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