wehub-resource-sync
9194ef5abd
7.0 KiB
template, comments, hide, description
| template | comments | hide | description | ||
|---|---|---|---|---|---|
| index.html | true |
|
Open-source Python library providing computer vision tools for annotating detections, tracking objects, counting in zones, and processing datasets. |
What is Supervision?
Supervision is an open-source Python library by Roboflow for building computer vision applications. It provides a unified Detections object with converters for supported outputs from Ultralytics, Roboflow Inference, Transformers, SAM, Detectron2, MMDetection, YOLO-NAS, PaddleDet, NCNN, Azure AI Vision, and VLM parsers.
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.
Supervision is MIT licensed, has 38,000+ GitHub stars, and over 1 million monthly PyPI downloads. It is developed in public on GitHub 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.10 environment.
!!! example "Installation"
=== "pip (recommended)"
[](https://badge.fury.io/py/supervision) [](https://pypistats.org/packages/supervision) [](../LICENSE.md) [](https://badge.fury.io/py/supervision)
```bash
pip install supervision
```
=== "poetry"
[](https://badge.fury.io/py/supervision) [](https://pypistats.org/packages/supervision) [](../LICENSE.md) [](https://badge.fury.io/py/supervision)
```bash
poetry add supervision
```
=== "uv"
[](https://badge.fury.io/py/supervision) [](https://pypistats.org/packages/supervision) [](../LICENSE.md) [](https://badge.fury.io/py/supervision)
```bash
uv pip install supervision
```
For uv projects:
```bash
uv add supervision
```
=== "rye"
[](https://badge.fury.io/py/supervision) [](https://pypistats.org/packages/supervision) [](../LICENSE.md) [](https://badge.fury.io/py/supervision)
```bash
rye add supervision
```
!!! example "conda/mamba install"
=== "conda"
[](https://anaconda.org/conda-forge/supervision) [](https://anaconda.org/conda-forge/supervision) [](https://anaconda.org/conda-forge/supervision) [](https://anaconda.org/conda-forge/supervision)
```bash
conda install -c conda-forge supervision
```
=== "mamba"
[](https://anaconda.org/conda-forge/supervision) [](https://anaconda.org/conda-forge/supervision) [](https://anaconda.org/conda-forge/supervision) [](https://anaconda.org/conda-forge/supervision)
```bash
mamba install -c conda-forge supervision
```
!!! example "git clone (for development)"
=== "virtualenv"
```bash
# 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 "."
```
=== "uv"
```bash
# 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
-
Track Objects
Discover how to enhance video analysis by implementing seamless object tracking
-
Detect Small Objects
Learn how to detect small objects in images
-
Count Objects Crossing Line
Explore methods to accurately count and analyze objects crossing a predefined line
-
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
supervisionfunctions