Skip to content

What is Supervision?

Supervision is an open-source Python library by Roboflow for building computer vision applications. It provides a unified Detections object that works with YOLO, SAM, Grounding DINO, Transformers, and 20+ model frameworks — use any detector, get the same composable API.

With Supervision you can annotate images and video with bounding boxes, masks, and labels; track objects across frames with persistent IDs; count and filter detections inside polygon zones; load and convert datasets between YOLO, COCO, and Pascal VOC formats; and benchmark model performance with mAP and confusion matrices.

Trusted by researchers (cited in 4,000+ papers) and practitioners (38,000+ GitHub stars, 1M+ monthly PyPI downloads), Supervision is the standard toolkit for production computer vision workflows.

👋 Hello

We write your reusable computer vision tools. Whether you need to load your dataset from your hard drive, draw detections on an image or video, or count how many detections are in a zone. You can count on us!

💻 Install

You can install supervision in a Python>=3.9 environment.

Installation

version downloads license python-version

pip install supervision

version downloads license python-version

poetry add supervision

version downloads license python-version

uv pip install supervision

For uv projects:

uv add supervision

version downloads license python-version

rye add supervision

conda/mamba install

conda-recipe conda-downloads conda-version conda-platforms

conda install -c conda-forge supervision

mamba-recipe mamba-downloads mamba-version mamba-platforms

mamba install -c conda-forge supervision

git clone (for development)

# clone repository and navigate to root directory
git clone --depth 1 -b develop https://github.com/roboflow/supervision.git
cd supervision

# setup python environment and activate it
python3 -m venv venv
source venv/bin/activate
pip install --upgrade pip

# installation
pip install -e "."

# clone repository and navigate to root directory
git clone --depth 1 -b develop https://github.com/roboflow/supervision.git
cd supervision

# setup python environment and activate it
uv venv
source .venv/bin/activate

# installation
uv pip install -r pyproject.toml -e . --all-extras

🚀 Quickstart

  • Detect and Annotate

    Annotate predictions from a range of object detection and segmentation models

    Tutorial

  • Track Objects

    Discover how to enhance video analysis by implementing seamless object tracking

    Tutorial

  • Detect Small Objects

    Learn how to detect small objects in images

    Tutorial

  • Count Objects Crossing Line

    Explore methods to accurately count and analyze objects crossing a predefined line

    Notebook

  • Filter Objects in Zone

    Master the techniques to selectively filter and focus on objects within a specific zone

  • Cheatsheet

    Access a quick reference guide to the most common supervision functions

    Cheatsheet

Comments