Skip to content

Installation

Quick option:

Pre-built binaries for Windows, macOS, and Linux are available on the GitHub Releases page. Download the latest release for your platform and run the executable—no installation required.


Requirements

  • Python 3.9 or later
  • PyQt6
  • Other dependencies (see Tool/requirements.txt)

Steps (from source)

Note: The PyQt GUI project lives in the Tool/ subdirectory of this repository. All commands below assume you are running them from the repository root unless stated otherwise.

  1. Clone the repository

    git clone https://github.com/OpenSportsLab/soccernetpro-ui.git
    cd soccernetpro-ui
    

  2. (Recommended) Create and activate a Conda environment

    conda create -n soccernetpro-ui python=3.9 -y
    conda activate soccernetpro-ui
    

  3. Install dependencies: The main dependencies are:

    • pyqt6
    • opencv-python (optional, for video rendering/computer vision)
    • See requirements.txt for the full list

    Install with pip:

    pip install pyqt6
    
    # Optional, for video rendering/computer vision:
    pip install opencv-python
    
    # Or install all dependencies:
    pip install -r Tool/requirements.txt
    
  4. Run the tool:

    python Tool/main.py
    

Troubleshooting