Installation

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.
Prerequisites
Python
You should use 🐍 Python 3.8 or greater, which can be installed either through the Anaconda package manager, Homebrew, or the Python website.
Libraries
apt-get update
apt-get install ffmpeg libgeos-dev libsm6 libxext6 libexiv2-dev libxrender-dev libboost-all-dev -y
Installation
Pip
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 https://github.com/supervisely/supervisely.git
Or, download the zipball:
$ curl -OL https://github.com/supervisely/supervisely/archive/refs/heads/master.zip
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:
unzip master.zip
cd supervisely-master
python3 -m pip3 install .
VENV
Here is the tiny bash script, that you can place at the root of your repository (for example create_venv.sh). 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.
#!/bin/bash
​
# learn more in documentation
# Official python docs: https://docs.python.org/3/library/venv.html
​
if [ -d ".venv" ]; then
    echo "VENV already exists, will be removed"
    rm -rf .venv
fi
​
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" && \
deactivate
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.

Supervisely Developer Portal

Next - Getting Started

Basics of authentication

Last modified 10d ago

Copy link

Edit on GitHub

Outline