Everything you need to know about installation of Supervisely SDK for Python

This part of the documentation covers the installation of Supervisely SDK for Python. The first step to using any software package is getting it properly installed.



You should use 🐍 Python 3.8 or greater, which can be installed either through the Anaconda package manager, Homebrew, or the Python website.


apt-get update
apt-get install ffmpeg libgeos-dev libsm6 libxext6 libexiv2-dev libxrender-dev libboost-all-dev -y



The latest stable version is available on PyPI. Either add supervisely to your requirements.txt file or install with pip:

pip3 install supervisely

We are constantly updating our SDK by adding new features and fixing bugs. So if it is already installed on your dev environment, use the installation command with --upgrade flag:

pip3 install --upgrade supervisely 

Source code

Supervisely is actively developed on GitHub, where the code is always available.

You can either clone the public repository:

git clone

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 supervisely-master
python3 -m pip3 install .


Here is a tiny bash script, that you can place at the root of your repository (for example It creates venv - β€œvirtual” isolated Python installation and installs packages into that virtual installation. When you switch projects, you can simply create a new virtual environment and not have to worry about breaking the packages installed in the other environments. It is always recommended to use a virtual environment while developing Python applications.


# learn more in documentation
# Official python docs:

if [ -d ".venv" ]; then
    echo "VENV already exists, will be removed"
    rm -rf .venv

echo "VENV will be created" && \
python3 -m venv .venv && \
source .venv/bin/activate && \

echo "Install requirements..." && \
pip3 install -r requirements.txt && \
echo "Requirements have been successfully installed" && \

Docker image

Supervisely SDK for python also has prebuilt docker image with everything already installed.

You can use the latest version

docker pull supervisely/base-py-sdk:latest

or some specific on that has completely the same tag as PIP releases, for example:

docker pull supervisely/base-py-sdk:6.33.0

Here are the links to dockerfiles (base image, result image) where you can find the complete list of all recommended dependencies.

Last updated