Spokes.wiki Search About
Software Source Code source ↗ source url updated Wed Aug 05 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Supervision

roboflow‘s Python library of reusable computer-vision utilities — “We write your reusable computer vision tools.” MIT, 48,725 stars and 4,608 forks, created 2022-11-28 and last pushed 2026-08-04, Python ≥3.10. Routed here on 2026-08-05.

What is actually in it

Read from the package rather than the README — 78 Python modules under supervision/, grouped as:

  • detectionsv.Detections, the common structure everything else operates on, plus filtering, non-max suppression and zone logic.
  • annotators / draw — box, mask, label, trace and heatmap renderers for drawing results onto images and video.
  • tracker — multi-object tracking, turning per-frame detections into identities across time.
  • dataset — loading, splitting, merging and converting between YOLO, COCO and Pascal VOC.
  • metrics — detection evaluation (mAP and friends).
  • classification, keypoint / key_points, geometry, utils, validators.

It is model-agnostic by design: it does not train, serve or contain a model. It connects to whatever produced the boxes — Ultralytics YOLO, Hugging Face Transformers, MMDetection, Roboflow Inference, RF-DETR — and takes over from there.

Why it is here, and where it strains the boundary

This spoke declared itself train-time and design-time. Supervision is neither: nothing in it runs during backprop. It is the layer after the model, and it was still the right home, because the alternative spokes fit worse — ../llm-inference-wiki is serve-time mechanism for LLMs specifically (logits, sampling, KV cache), and ../dev-tooling-wiki declines application-level runtime libraries under the standing Ky precedent.

The better reason is that two of its modules land on this spoke’s own live growth edges. dataset is data curation — the format conversion that consumes a real share of any vision project. metrics is evaluation. Both were named as the unfilled half of the missing-middle edge after transformers-tutorials supplied the training loop and reported nothing about whether the result was good. Supervision does not close either edge, since a library is not a study, but it is the first source here that treats evaluation as a thing you install rather than a thing you should have done.

What it says about the demo-to-production gap

More concretely than anything else in the corpus. demo-to-production-gap has been a claim without a mechanism — a catalog of successes with no denominator, and a headline about failures nobody could read. This is a partial answer from the other direction: 48.7k stars’ worth of demand for the unglamorous parts. Not the model, not the training. Converting between three annotation formats, holding identity across frames, drawing a box, counting what crossed a line, computing mAP.

The gap between a notebook that detects objects and a system that does something useful is filled with exactly this, and it is telling that it took a company’s dedicated library and three and a half years.

Caveats

  • Vendor-adjacent. roboflow sells a commercial computer-vision platform; the free library feeds its inference product and its dataset formats. Normal, and recorded rather than held against it — the same pattern the hub keeps meeting in maintainer-owned repositories.
  • No numbers. The repository makes no performance, accuracy or adoption claims beyond the star count, so there is nothing here to verify and nothing to distrust.
  • Star and fork counts are a 2026-08-05 snapshot.

Tier

T2 — a first-party repository from an interested vendor, but the substance is code rather than claims: the module structure, the integrations and the API surface were read from the tree, and the library asserts nothing about its own effectiveness.

roboflow · transformers-tutorials · demo-to-production-gap · ml-system-design · synthesis