Supervision de Roboflow: librería Python para visión por computadora con 38.000 estrellas en GitHub

Detecciones unificadas, anotación de vídeo, tracking, conteo en zonas y conversión de datasets YOLO/COCO/VOC. Compatible con Ultralytics, SAM, Detectron2 y más. MIT · pip install supervision.

Supervision: librería Python open source de Roboflow para visión por computadora y detección de objetos
Supervision centraliza herramientas reutilizables para cargar datasets, anotar predicciones y contar detecciones en zonas. Fuente: Supervision Docs

Supervision es la librería Python open source de Roboflow para construir aplicaciones de visión por computadora en producción. Según la documentación oficial, ofrece un objeto Detections unificado, convertidores para decenas de backends de inferencia y utilidades listas para anotar, trackear, filtrar y evaluar modelos — «We write your reusable computer vision tools».

Qué resuelve Supervision

Trabajar con visión por computadora implica repetir tareas: parsear salidas de modelos distintos, dibujar cajas y máscaras, persistir IDs entre frames o contar objetos que cruzan una línea. Supervision empaqueta eso en APIs coherentes sobre el tipo Detections.

  • Anotación: bounding boxes, máscaras y etiquetas en imágenes y vídeo.
  • Tracking: seguimiento de objetos con IDs persistentes frame a frame.
  • Zonas y líneas: contar y filtrar detecciones dentro de polígonos o al cruzar una Line Zone.
  • Datasets: cargar y convertir entre formatos YOLO, COCO y Pascal VOC.
  • Métricas: evaluar modelos con mAP, precisión, recall, F1 y matrices de confusión.

Integraciones soportadas

El punto fuerte de Supervision es la capa de conversión: el mismo flujo de anotación y postprocesado sirve tras inferir con:

  • Ultralytics (YOLOv8/v11, etc.)
  • Roboflow Inference
  • Transformers (Hugging Face)
  • SAM (Segment Anything)
  • Detectron2, MMDetection, YOLO-NAS, PaddleDet
  • NCNN, Azure AI Vision y parsers de VLMs

Eso reduce el código «pegamento» cuando cambias de modelo o mezclas detección con segmentación.

Herramientas destacadas

La documentación organiza recetas y referencia API en módulos concretos:

  • Line Zone y Polygon Zone: conteo y filtrado espacial.
  • Inference Slicer: detectar objetos pequeños dividiendo la imagen en tiles.
  • Detection Smoother: suavizar predicciones ruidosas en vídeo.
  • Annotators: renderizado visual de detecciones y keypoints.
  • Trackers: integración con pipelines de seguimiento multiobjeto.

Hay tutoriales paso a paso (detectar y anotar, guardar detecciones, trackear en vídeo, benchmark de modelos) y cookbooks en la web de docs.

Instalación

Requiere Python ≥ 3.9. Instalación recomendada:

pip install supervision

También disponible vía poetry, uv, rye o conda install -c conda-forge supervision. Para desarrollo: clonar github.com/roboflow/supervision e instalar en editable con pip install -e ..

Ecosistema Roboflow

Supervision complementa el stack de Roboflow (etiquetado, entrenamiento, despliegue con Inference). La librería es el lado «código abierto reutilizable» para equipos que ya despliegan modelos en edge, servidor o notebooks — sin atarte a un solo framework de detección.

En resumen

¿Qué es? Librería Python MIT para CV post-inferencia. ¿Para qué? Anotar, trackear, contar en zonas, convertir datasets y medir mAP. ¿Cómo empezar? pip install supervision y la documentación.