
Supervision
github.com/roboflow/supervision- Category
- Developer Tools
- Rank
- No. 135Tools index
- Pricing
- Open Source
- Type
- TOOL
- Builder
- roboflow
- GitHub
- 49.9k stars
- Latest release
- 0.30.2
- Date
About
A Python library that provides reusable computer vision tools for object detection, tracking, and annotation. Works with any model and includes utilities for dataset management, visualization, and zone analysis.
What it does
Supervision turns model results into common data structures, then helps you inspect, transform, measure, draw, and export them. It also handles images and video, converts annotation formats, and supplies composable pieces for spatial and time-based analysis.
Why it's ranked here
The breadth is unusually practical: one package connects model output, visual debugging, dataset conversion, evaluation, video processing, and application logic. Its model-neutral approach reduces glue code, while documented examples make the large surface easier to approach.
What's good
It supports classification, detection, segmentation, key points, oriented boxes, and vision-language results. Dataset tools cover COCO, YOLO, and Pascal VOC. The public surface also includes overlap filtering, suppression, metrics, image transforms, video input and output, zones, sinks, and many configurable annotators.
Tradeoffs
This is a substantial dependency stack, including numerical, imaging, plotting, video, networking, and scientific packages. Python 3.10 or newer is required. Model execution remains an adjacent concern, and some integrations need optional packages or external credentials. Without OpenCV, fallback operations may run slower or behave slightly differently.
How to use it well
Use it when model predictions need a consistent path into visualization, evaluation, dataset preparation, tracking, or video analytics. It best suits Python teams assembling computer vision applications from existing models. Bring a separate inference framework or service, because Supervision does not itself supply the trained model shown in its examples.
Technical notes+
pyproject.toml defines a setuptools build from src, requires Python >=3.10, ships py.typed, enables strict mypy, and configures pytest over src and tests. src/supervision/__init__.py exposes a broad library API and lazily resolves the deprecated ByteTrack compatibility export. src/supervision/_cv2/__init__.py selects native OpenCV when available and otherwise maps supported operations to internal NumPy-backed implementations while warning about performance and behavioral differences. src/supervision/keypoint/__init__.py redirects users toward the newer key-points module through a deprecation warning.
Observed
- License
- MIT
- Primary language
- Python
- Installation
- Published package installable with pip as supervision
- Python support
- Requires Python 3.10 or newer; classifiers list Python 3.10 through 3.14
- Interface
- Importable Python library
- Platform support
- Package classifiers list macOS, Microsoft Windows, and POSIX Linux
- Packaging
- Setuptools build backend with a src-based package layout and bundled typing marker
- OpenCV behavior
- Uses OpenCV when installed and provides an internal fallback backend otherwise
Read from README.md, pyproject.toml, src/supervision/__init__.py, src/supervision/_cv2/__init__.py, src/supervision/assets/__init__.py, src/supervision/metrics/__init__.py, src/supervision/tracker/__init__.py, src/supervision/keypoint/__init__.py.
What it can do
Detect objects in images or video
Image or video file with any detection model → Object detection results with bounding boxes and labels
Track objects across video frames
Video file and object detection results → Object trajectories with unique IDs over time
Annotate images with detection visualizations
Image and detection data → Annotated image with bounding boxes, labels, and visual overlays
Count objects within defined zones
Detection results and zone boundaries → Object counts and zone analysis statistics
Load and manage computer vision datasets
Dataset files in various formats → Structured dataset objects for training or inference
Visualize detection results and analytics
Detection data and configuration parameters → Charts, graphs, and visual summaries of computer vision results
Intel on Supervision
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.