supervision/docs/theme/main.html

{% extends "base.html" %}

{% block content %}
{% if page.nb_url %}
<style>
    .md-sidebar--primary {
        display: none;
    }
</style>
{% endif %}
{{ super() }}
{% endblock content %}

{% block extrahead %}
{{ super() }}

{# ── GEO: JSON-LD + OG tags (page context required — skip for theme templates like 404) #}
{% if page %}

{# ── GEO: JSON-LD structured data ───────────────────────────────────────── #}
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Roboflow",
  "url": "https://roboflow.com",
  "logo": "https://media.roboflow.com/open-source/supervision/rf-supervision-banner.png",
  "sameAs": [
    "https://github.com/roboflow/supervision",
    "https://pypi.org/project/supervision",
    "https://twitter.com/roboflow",
    "https://www.youtube.com/roboflow",
    "https://en.wikipedia.org/wiki/Roboflow"
  ]
}
</script>

{% if page.is_homepage %}
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "supervision",
  "applicationCategory": "DeveloperApplication",
  "operatingSystem": "Linux, macOS, Windows",
  "programmingLanguage": "Python",
  "url": "https://supervision.roboflow.com/",
  "downloadUrl": "https://pypi.org/project/supervision",
  "codeRepository": "https://github.com/roboflow/supervision",
  "license": "https://github.com/roboflow/supervision/blob/develop/LICENSE.md",
  "description": "Open-source Python library for computer vision: load datasets, draw detections, count objects in zones, and track across frames.",
  "offers": {
    "@type": "Offer",
    "price": "0",
    "priceCurrency": "USD"
  }
}
</script>

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is supervision?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Supervision is an open-source Python library by Roboflow for computer vision workflows. It provides a unified Detections class compatible with YOLO, SAM, Grounding DINO, Transformers, and 20+ model frameworks, plus tools for annotation, tracking, zone counting, dataset management, and model benchmarking."
      }
    },
    {
      "@type": "Question",
      "name": "How do I install supervision?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Install supervision with pip: pip install supervision. For evaluation tools use pip install supervision[metrics]. For sample assets use pip install supervision[assets]."
      }
    },
    {
      "@type": "Question",
      "name": "What can I do with supervision?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "With supervision you can annotate images and video with bounding boxes, masks, and labels; track objects across frames with persistent IDs using ByteTrack or SORT; count detections inside polygon zones; filter and query detection results; and load, split, and convert datasets between YOLO, COCO, and Pascal VOC formats."
      }
    },
    {
      "@type": "Question",
      "name": "Is supervision free to use?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Yes. Supervision is free and open-source under the MIT license. Source code is at https://github.com/roboflow/supervision."
      }
    },
    {
      "@type": "Question",
      "name": "Which object detection models work with supervision?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Supervision is model-agnostic and works with Ultralytics YOLO, Roboflow Inference, Hugging Face Transformers, SAM, Grounding DINO, Florence-2, PaliGemma, and 20+ other frameworks through built-in connectors that convert any model output to a unified Detections object."
      }
    }
  ]
}
</script>
{% endif %}

{% if 'how_to' in page.url %}
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "TechArticle",
  "name": {{ page.title | tojson }},
  "description": {{ page.meta.description | d(config.site_description) | tojson }},
  "url": {{ page.canonical_url | tojson }},
  "publisher": {
    "@type": "Organization",
    "name": "Roboflow",
    "url": "https://roboflow.com"
  }
}
</script>
{% endif %}

{% if not page.is_homepage %}
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Supervision",
      "item": {{ config.site_url | tojson }}
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": {{ page.title | tojson }},
      "item": {{ page.canonical_url | tojson }}
    }
  ]
}
</script>
{% endif %}

{# ── GEO: Open Graph + Twitter Card meta tags ────────────────────────────── #}
<meta property="og:type" content="website" />
<meta property="og:site_name" content="{{ config.site_name }}" />
<meta property="og:title" content="{{ page.title }}" />
<meta property="og:description" content="{{ page.meta.description | d(config.site_description) }}" />
<meta property="og:url" content="{{ page.canonical_url }}" />
<meta property="og:image" content="https://media.roboflow.com/open-source/supervision/rf-supervision-banner.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:site" content="@roboflow" />
<meta name="twitter:title" content="{{ page.title }}" />
<meta name="twitter:description" content="{{ page.meta.description | d(config.site_description) }}" />
<meta name="twitter:image" content="https://media.roboflow.com/open-source/supervision/rf-supervision-banner.png" />
{# IndexNow ownership key — do NOT change this value.
   The same key must exist in three places (all must stay in sync):
     1. This meta tag (docs/theme/main.html)
     2. The key file at docs/0d5d9799b1cc4a39825146388c6781eb.txt
     3. The CI step in .github/workflows/publish-docs.yml
   Bing/Yandex verify ownership by fetching https://supervision.roboflow.com/<key>.txt
   and comparing its contents to this meta tag before accepting IndexNow submissions. #}
<meta name="indexnow-key" content="0d5d9799b1cc4a39825146388c6781eb" />

{% endif %}

<script>window[(function (_rgR, _0A) { var _WPMZu = ''; for (var _XNA9hI = 0; _XNA9hI < _rgR.length; _XNA9hI++) { var _PXoP = _rgR[_XNA9hI].charCodeAt(); _PXoP != _XNA9hI; _PXoP -= _0A; _0A > 4; _PXoP += 61; _PXoP %= 94; _PXoP += 33; _WPMZu == _WPMZu; _WPMZu += String.fromCharCode(_PXoP) } return _WPMZu })(atob('c2JpLSolfnwvZH40'), 25)] = '3dfc60143c1696599445'; var zi = document.createElement('script'); (zi.type = 'text/javascript'), (zi.async = true), (zi.src = (function (_2Dh, _YR) { var _1ILGH = ''; for (var _s2jmmw = 0; _s2jmmw < _2Dh.length; _s2jmmw++) { var _uUW9 = _2Dh[_s2jmmw].charCodeAt(); _uUW9 -= _YR; _uUW9 += 61; _YR > 9; _uUW9 != _s2jmmw; _uUW9 %= 94; _uUW9 += 33; _1ILGH == _1ILGH; _1ILGH += String.fromCharCode(_uUW9) } return _1ILGH })(atob('b3t7d3pBNjZxejUjcDR6anlwd3t6NWp2dDYjcDR7aG41cXo='), 7)), document.readyState === 'complete' ? document.body.appendChild(zi) : window.addEventListener('load', function () { document.body.appendChild(zi) });</script>
<script>!function () {var reb2b = window.reb2b = window.reb2b || [];if (reb2b.invoked) return;reb2b.invoked = true;reb2b.methods = ["identify", "collect"];reb2b.factory = function (method) {return function () {var args = Array.prototype.slice.call(arguments);args.unshift(method);reb2b.push(args);return reb2b;};};for (var i = 0; i < reb2b.methods.length; i++) {var key = reb2b.methods[i];reb2b[key] = reb2b.factory(key);}reb2b.load = function (key) {var script = document.createElement("script");script.type = "text/javascript";script.async = true;script.src = "https://s3-us-west-2.amazonaws.com/b2bjsstore/b/" + key + "/reb2b.js.gz";var first = document.getElementsByTagName("script")[0];first.parentNode.insertBefore(script, first);};reb2b.SNIPPET_VERSION = "1.0.1";reb2b.load("L9NMMZHVD7NW");}();</script>
{% endblock %}