Before you can use socceraction, you’ll need to get it installed. This guide will guide you to a minimal installation that’ll work while you walk through the introduction.

Install Python

Being a Python library, socceraction requires Python. Currently, socceraction supports Python version 3.9 – 3.11. Get the latest version of Python at or with your operating system’s package manager.

You can verify that Python is installed by typing python from your shell; you should see something like:

Python 3.x.y
[GCC 4.x] on linux
Type "help", "copyright", "credits" or "license" for more information.

Install socceraction

You’ve got two options to install socceraction.

Installing an official release with pip

This is the recommended way to install socceraction. Simply run this simple command in your terminal of choice:

$ python -m pip install socceraction

You might have to install pip first. The easiest method is to use the standalone pip installer.

Installing the development version

Socceraction is actively developed on GitHub, where the code is always available. You can easily install the development version with:

$ pip install git+

However, to be able to make modifications in the code, you should either clone the public repository:

$ git clone git://

Or, download the zipball:

$ curl -OL

Once you have a copy of the source, you can embed it in your own Python package, or install it into your site-packages easily:

$ cd socceraction
$ python -m pip install -e .


To verify that socceraction can be seen by Python, type python from your shell. Then at the Python prompt, try to import socceraction:

>>> import socceraction
>>> print(socceraction.__version__)