PyPI - superiorvision - Versions diffs - 0.30.0.dev0__tar.gz → 0.30.0.dev2__tar.gz - Mend

superiorvision 0.30.0.dev0tar.gz → 0.30.0.dev2tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (103) hide show

{superiorvision-0.30.0.dev0/src/superiorvision.egg-info → superiorvision-0.30.0.dev2}/PKG-INFO RENAMED Viewed

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: superiorvision
-Version: 0.30.0.dev0
+Version: 0.30.0.dev2
 Summary: A tensor-native, inference-focused fork of Supervision
 Author-email: "Roboflow et al." <develop@roboflow.com>
 Maintainer-email: Piotr Skalski <piotr@roboflow.com>
 License-Expression: MIT
 Project-URL: Documentation, https://supervision.roboflow.com/latest/
-Project-URL: Homepage, https://github.com/roboflow/supervision
-Project-URL: Repository, https://github.com/roboflow/supervision
+Project-URL: Homepage, https://github.com/roboflow/superiorvision
+Project-URL: Repository, https://github.com/roboflow/superiorvision
 Keywords: AI,deep-learning,DL,machine-learning,ML,Roboflow,vision
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
@@ -72,18 +72,14 @@ If detections begin as tensors, converting them to NumPy so the next operation
 can turn them back into tensors is not "compatibility." It is cardio.
 SuperiorVision declines the workout.
-[![version](https://badge.fury.io/py/supervision.svg)](https://badge.fury.io/py/supervision) [![downloads](https://img.shields.io/pypi/dm/supervision)](https://pypistats.org/packages/supervision) [![license](https://img.shields.io/pypi/l/supervision)](LICENSE.md) [![python-version](https://img.shields.io/pypi/pyversions/supervision)](https://badge.fury.io/py/supervision) [![codecov](https://codecov.io/gh/roboflow/supervision/graph/badge.svg?token=HMNJ5FVZ36)](https://codecov.io/gh/roboflow/supervision)
+[![version](https://img.shields.io/pypi/v/superiorvision)](https://pypi.org/project/superiorvision/) [![downloads](https://img.shields.io/pypi/dm/superiorvision)](https://pypistats.org/packages/superiorvision) [![license](https://img.shields.io/pypi/l/superiorvision)](LICENSE.md) [![python-version](https://img.shields.io/pypi/pyversions/superiorvision)](https://pypi.org/project/superiorvision/)
-[![snyk](https://snyk.io/advisor/python/supervision/badge.svg)](https://snyk.io/advisor/python/supervision) [![colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/roboflow/supervision/blob/main/demo.ipynb) [![gradio](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-blue)](https://huggingface.co/spaces/Roboflow/Annotators) [![discord](https://img.shields.io/discord/1159501506232451173?logo=discord&label=discord&labelColor=fff&color=5865f2&link=https%3A%2F%2Fdiscord.gg%2FGbfgXGJ8Bk)](https://discord.gg/GbfgXGJ8Bk)
-<div align="center">
-    <a href="https://trendshift.io/repositories/124"  target="_blank"><img src="https://trendshift.io/api/badge/repositories/124" alt="roboflow%2Fsupervision | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
-  </div>
+[![gradio](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-blue)](https://huggingface.co/spaces/Roboflow/Annotators) [![discord](https://img.shields.io/discord/1159501506232451173?logo=discord&label=discord&labelColor=fff&color=5865f2&link=https%3A%2F%2Fdiscord.gg%2FGbfgXGJ8Bk)](https://discord.gg/GbfgXGJ8Bk)
 Same API. Fewer NumPy vacations.
 For the external multi-object trackers used by Inference, pair SuperiorVision
-with the private [Tracktors](https://github.com/roboflow/tracktors) fork. The
+with the [Tracktors](https://pypi.org/project/tracktors/) package. The
 dependency points one way—Tracktors consumes tensor-native `sv.Detections`—so
 SuperiorVision keeps its existing `sv.ByteTrack` compatibility API without a
 circular package dependency.
@@ -98,7 +94,7 @@ circular package dependency.
     - [Annotators](#annotators)
     - [Datasets](#datasets)
 - [🎬 Tutorials](#-tutorials)
-- [💜 Built with Supervision](#-built-with-supervision)
+- [💜 Built with the API](#-built-with-the-api)
 - [📚 Documentation](#-documentation)
 - [🏆 Contribution](#-contribution)
@@ -106,11 +102,22 @@ circular package dependency.
 ## 👋 Hello
-**We are your essential toolkit for computer vision.** From data loading to real-time zone counting, we provide the building blocks so you can focus on building applications around your models. 🤝
+**The familiar computer-vision toolkit, now with fewer surprise trips to the
+CPU.** From tensor-native detections to real-time zone counting, SuperiorVision
+keeps the compatible building blocks used by Inference while letting GPUs do
+the job they were purchased to do. 🤝
 ## 💻 Install
-Pip install the supervision package in a [**Python>=3.10**](https://www.python.org/) environment.
+Install the SuperiorVision distribution in a
+[**Python>=3.10**](https://www.python.org/) environment. The published version
+is currently a development release, so pin it explicitly:
+```bash
+pip install superiorvision==0.30.0.dev2
+```
+For an editable checkout:
 ```bash
 git clone git@github.com:roboflow/superiorvision.git
@@ -125,9 +132,10 @@ import supervision as sv       # existing Inference code
 import superiorvision as sv    # cheekier spelling, same API
 ```
-Because SuperiorVision provides the `supervision` namespace, install it as a
-replacement for upstream Supervision, not beside it. Two packages cannot both
-own the same trench coat and pretend everything is fine.
+The PyPI distribution is named `superiorvision`, but it intentionally provides
+the `supervision` import namespace for drop-in compatibility. Install it as a
+replacement for upstream Supervision, not beside it. Two distributions cannot
+both own the same trench coat and pretend everything is fine.
 The upstream documentation below remains useful for the compatible API surface.
@@ -135,7 +143,7 @@ The upstream documentation below remains useful for the compatible API surface.
 ### Models
-Supervision was designed to be model agnostic. Just plug in any classification, detection, or segmentation model. For your convenience, we have created [connectors](https://supervision.roboflow.com/latest/detection/core/#detections) for the most popular libraries like Ultralytics, Transformers, MMDetection, or Inference. Other integrations, like `rfdetr`, already return `sv.Detections` directly.
+SuperiorVision preserves Supervision's model-agnostic API. Just plug in any classification, detection, or segmentation model. The compatible [connectors](https://supervision.roboflow.com/latest/detection/core/#detections) cover popular libraries such as Ultralytics, Transformers, MMDetection, and Inference. Other integrations, including `rfdetr`, already return `sv.Detections` directly.
 Install the optional dependencies for this example with `pip install pillow rfdetr`.
@@ -177,7 +185,7 @@ len(detections)
 ### Annotators
-Supervision offers a wide range of highly customizable [annotators](https://supervision.roboflow.com/latest/detection/annotators/), allowing you to compose the perfect visualization for your use case.
+SuperiorVision retains the wide range of customizable [annotators](https://supervision.roboflow.com/latest/detection/annotators/) from its upstream API, allowing you to compose the visualization your use case needs.
 ```python
 import cv2
@@ -195,7 +203,7 @@ https://github.com/roboflow/supervision/assets/26109316/691e219c-0565-4403-9218-
 ### Datasets
-Supervision provides a set of [utils](https://supervision.roboflow.com/latest/datasets/core/) that allow you to load, split, merge, and save datasets in one of the supported formats.
+SuperiorVision retains the compatible [dataset utilities](https://supervision.roboflow.com/latest/datasets/core/) for loading, splitting, merging, and saving supported formats. Dataset and image I/O remain deliberate CPU boundaries; tensor-native runtime paths do not need to cosplay as JPEG encoders.
 ```python
 import supervision as sv
@@ -309,7 +317,7 @@ for path, image, annotation in ds:
 ## 🎬 Tutorials
-Want to learn how to use Supervision? Explore our [how-to guides](https://supervision.roboflow.com/develop/how_to/detect_and_annotate/), [end-to-end examples](./examples), [cheatsheet](https://roboflow.github.io/cheatsheet-supervision/), and [cookbooks](https://supervision.roboflow.com/develop/cookbooks/)!
+Want to learn the compatible API? Explore the upstream [how-to guides](https://supervision.roboflow.com/develop/how_to/detect_and_annotate/), [end-to-end examples](./examples), [cheatsheet](https://roboflow.github.io/cheatsheet-supervision/), and [cookbooks](https://supervision.roboflow.com/develop/cookbooks/)!
 <br/>
@@ -327,9 +335,9 @@ Want to learn how to use Supervision? Explore our [how-to guides](https://superv
 <div><strong>Created: 11 Jan 2024</strong></div>
 <br/>Learn how to track and estimate the speed of vehicles using YOLO, ByteTrack, and Roboflow Inference. This comprehensive tutorial covers object detection, multi-object tracking, filtering detections, perspective transformation, speed estimation, visualization improvements, and more.</p>
-## 💜 Built with Supervision
+## 💜 Built with the API
-Did you build something cool using supervision? [Let us know!](https://github.com/roboflow/supervision/discussions/categories/built-with-supervision)
+Did you build something cool using the compatible `supervision` API? [Tell us in the SuperiorVision repository.](https://github.com/roboflow/superiorvision)
 https://user-images.githubusercontent.com/26109316/207858600-ee862b22-0353-440b-ad85-caa0c4777904.mp4
@@ -339,15 +347,15 @@ https://github.com/roboflow/supervision/assets/26109316/3ac6982f-4943-4108-9b7f-
 ## 📚 Documentation
-Visit our [documentation](https://roboflow.github.io/supervision) page to learn how supervision can help you build computer vision applications faster and more reliably.
+The [upstream Supervision documentation](https://supervision.roboflow.com/latest/) describes the compatible API. Fork-specific tensor coverage and Inference compatibility are tracked in [this repository](https://github.com/roboflow/superiorvision) and [the Inference API surface audit](INFERENCE_API_SURFACE.md).
 ## 🏆 Contribution
-We love your input! Please see our [contributing guide](.github/CONTRIBUTING.md) to get started. Thank you 🙏 to all our contributors!
+We love your input! Please see our [contributing guide](.github/CONTRIBUTING.md) to get started. The fork lives at [`roboflow/superiorvision`](https://github.com/roboflow/superiorvision); upstream-compatible changes may still belong in Supervision. Thank you 🙏 to all our contributors!
 <p align="center">
-    <a href="https://github.com/roboflow/supervision/graphs/contributors">
-      <img src="https://contrib.rocks/image?repo=roboflow/supervision" />
+    <a href="https://github.com/roboflow/superiorvision/graphs/contributors">
+      <img src="https://contrib.rocks/image?repo=roboflow/superiorvision" />
     </a>
 </p>

{superiorvision-0.30.0.dev0 → superiorvision-0.30.0.dev2}/README.md RENAMED Viewed

@@ -21,18 +21,14 @@ If detections begin as tensors, converting them to NumPy so the next operation
 can turn them back into tensors is not "compatibility." It is cardio.
 SuperiorVision declines the workout.
-[![version](https://badge.fury.io/py/supervision.svg)](https://badge.fury.io/py/supervision) [![downloads](https://img.shields.io/pypi/dm/supervision)](https://pypistats.org/packages/supervision) [![license](https://img.shields.io/pypi/l/supervision)](LICENSE.md) [![python-version](https://img.shields.io/pypi/pyversions/supervision)](https://badge.fury.io/py/supervision) [![codecov](https://codecov.io/gh/roboflow/supervision/graph/badge.svg?token=HMNJ5FVZ36)](https://codecov.io/gh/roboflow/supervision)
+[![version](https://img.shields.io/pypi/v/superiorvision)](https://pypi.org/project/superiorvision/) [![downloads](https://img.shields.io/pypi/dm/superiorvision)](https://pypistats.org/packages/superiorvision) [![license](https://img.shields.io/pypi/l/superiorvision)](LICENSE.md) [![python-version](https://img.shields.io/pypi/pyversions/superiorvision)](https://pypi.org/project/superiorvision/)
-[![snyk](https://snyk.io/advisor/python/supervision/badge.svg)](https://snyk.io/advisor/python/supervision) [![colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/roboflow/supervision/blob/main/demo.ipynb) [![gradio](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-blue)](https://huggingface.co/spaces/Roboflow/Annotators) [![discord](https://img.shields.io/discord/1159501506232451173?logo=discord&label=discord&labelColor=fff&color=5865f2&link=https%3A%2F%2Fdiscord.gg%2FGbfgXGJ8Bk)](https://discord.gg/GbfgXGJ8Bk)
-<div align="center">
-    <a href="https://trendshift.io/repositories/124"  target="_blank"><img src="https://trendshift.io/api/badge/repositories/124" alt="roboflow%2Fsupervision | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
-  </div>
+[![gradio](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-blue)](https://huggingface.co/spaces/Roboflow/Annotators) [![discord](https://img.shields.io/discord/1159501506232451173?logo=discord&label=discord&labelColor=fff&color=5865f2&link=https%3A%2F%2Fdiscord.gg%2FGbfgXGJ8Bk)](https://discord.gg/GbfgXGJ8Bk)
 Same API. Fewer NumPy vacations.
 For the external multi-object trackers used by Inference, pair SuperiorVision
-with the private [Tracktors](https://github.com/roboflow/tracktors) fork. The
+with the [Tracktors](https://pypi.org/project/tracktors/) package. The
 dependency points one way—Tracktors consumes tensor-native `sv.Detections`—so
 SuperiorVision keeps its existing `sv.ByteTrack` compatibility API without a
 circular package dependency.
@@ -47,7 +43,7 @@ circular package dependency.
     - [Annotators](#annotators)
     - [Datasets](#datasets)
 - [🎬 Tutorials](#-tutorials)
-- [💜 Built with Supervision](#-built-with-supervision)
+- [💜 Built with the API](#-built-with-the-api)
 - [📚 Documentation](#-documentation)
 - [🏆 Contribution](#-contribution)
@@ -55,11 +51,22 @@ circular package dependency.
 ## 👋 Hello
-**We are your essential toolkit for computer vision.** From data loading to real-time zone counting, we provide the building blocks so you can focus on building applications around your models. 🤝
+**The familiar computer-vision toolkit, now with fewer surprise trips to the
+CPU.** From tensor-native detections to real-time zone counting, SuperiorVision
+keeps the compatible building blocks used by Inference while letting GPUs do
+the job they were purchased to do. 🤝
 ## 💻 Install
-Pip install the supervision package in a [**Python>=3.10**](https://www.python.org/) environment.
+Install the SuperiorVision distribution in a
+[**Python>=3.10**](https://www.python.org/) environment. The published version
+is currently a development release, so pin it explicitly:
+```bash
+pip install superiorvision==0.30.0.dev2
+```
+For an editable checkout:
 ```bash
 git clone git@github.com:roboflow/superiorvision.git
@@ -74,9 +81,10 @@ import supervision as sv       # existing Inference code
 import superiorvision as sv    # cheekier spelling, same API
 ```
-Because SuperiorVision provides the `supervision` namespace, install it as a
-replacement for upstream Supervision, not beside it. Two packages cannot both
-own the same trench coat and pretend everything is fine.
+The PyPI distribution is named `superiorvision`, but it intentionally provides
+the `supervision` import namespace for drop-in compatibility. Install it as a
+replacement for upstream Supervision, not beside it. Two distributions cannot
+both own the same trench coat and pretend everything is fine.
 The upstream documentation below remains useful for the compatible API surface.
@@ -84,7 +92,7 @@ The upstream documentation below remains useful for the compatible API surface.
 ### Models
-Supervision was designed to be model agnostic. Just plug in any classification, detection, or segmentation model. For your convenience, we have created [connectors](https://supervision.roboflow.com/latest/detection/core/#detections) for the most popular libraries like Ultralytics, Transformers, MMDetection, or Inference. Other integrations, like `rfdetr`, already return `sv.Detections` directly.
+SuperiorVision preserves Supervision's model-agnostic API. Just plug in any classification, detection, or segmentation model. The compatible [connectors](https://supervision.roboflow.com/latest/detection/core/#detections) cover popular libraries such as Ultralytics, Transformers, MMDetection, and Inference. Other integrations, including `rfdetr`, already return `sv.Detections` directly.
 Install the optional dependencies for this example with `pip install pillow rfdetr`.
@@ -126,7 +134,7 @@ len(detections)
 ### Annotators
-Supervision offers a wide range of highly customizable [annotators](https://supervision.roboflow.com/latest/detection/annotators/), allowing you to compose the perfect visualization for your use case.
+SuperiorVision retains the wide range of customizable [annotators](https://supervision.roboflow.com/latest/detection/annotators/) from its upstream API, allowing you to compose the visualization your use case needs.
 ```python
 import cv2
@@ -144,7 +152,7 @@ https://github.com/roboflow/supervision/assets/26109316/691e219c-0565-4403-9218-
 ### Datasets
-Supervision provides a set of [utils](https://supervision.roboflow.com/latest/datasets/core/) that allow you to load, split, merge, and save datasets in one of the supported formats.
+SuperiorVision retains the compatible [dataset utilities](https://supervision.roboflow.com/latest/datasets/core/) for loading, splitting, merging, and saving supported formats. Dataset and image I/O remain deliberate CPU boundaries; tensor-native runtime paths do not need to cosplay as JPEG encoders.
 ```python
 import supervision as sv
@@ -258,7 +266,7 @@ for path, image, annotation in ds:
 ## 🎬 Tutorials
-Want to learn how to use Supervision? Explore our [how-to guides](https://supervision.roboflow.com/develop/how_to/detect_and_annotate/), [end-to-end examples](./examples), [cheatsheet](https://roboflow.github.io/cheatsheet-supervision/), and [cookbooks](https://supervision.roboflow.com/develop/cookbooks/)!
+Want to learn the compatible API? Explore the upstream [how-to guides](https://supervision.roboflow.com/develop/how_to/detect_and_annotate/), [end-to-end examples](./examples), [cheatsheet](https://roboflow.github.io/cheatsheet-supervision/), and [cookbooks](https://supervision.roboflow.com/develop/cookbooks/)!
 <br/>
@@ -276,9 +284,9 @@ Want to learn how to use Supervision? Explore our [how-to guides](https://superv
 <div><strong>Created: 11 Jan 2024</strong></div>
 <br/>Learn how to track and estimate the speed of vehicles using YOLO, ByteTrack, and Roboflow Inference. This comprehensive tutorial covers object detection, multi-object tracking, filtering detections, perspective transformation, speed estimation, visualization improvements, and more.</p>
-## 💜 Built with Supervision
+## 💜 Built with the API
-Did you build something cool using supervision? [Let us know!](https://github.com/roboflow/supervision/discussions/categories/built-with-supervision)
+Did you build something cool using the compatible `supervision` API? [Tell us in the SuperiorVision repository.](https://github.com/roboflow/superiorvision)
 https://user-images.githubusercontent.com/26109316/207858600-ee862b22-0353-440b-ad85-caa0c4777904.mp4
@@ -288,15 +296,15 @@ https://github.com/roboflow/supervision/assets/26109316/3ac6982f-4943-4108-9b7f-
 ## 📚 Documentation
-Visit our [documentation](https://roboflow.github.io/supervision) page to learn how supervision can help you build computer vision applications faster and more reliably.
+The [upstream Supervision documentation](https://supervision.roboflow.com/latest/) describes the compatible API. Fork-specific tensor coverage and Inference compatibility are tracked in [this repository](https://github.com/roboflow/superiorvision) and [the Inference API surface audit](INFERENCE_API_SURFACE.md).
 ## 🏆 Contribution
-We love your input! Please see our [contributing guide](.github/CONTRIBUTING.md) to get started. Thank you 🙏 to all our contributors!
+We love your input! Please see our [contributing guide](.github/CONTRIBUTING.md) to get started. The fork lives at [`roboflow/superiorvision`](https://github.com/roboflow/superiorvision); upstream-compatible changes may still belong in Supervision. Thank you 🙏 to all our contributors!
 <p align="center">
-    <a href="https://github.com/roboflow/supervision/graphs/contributors">
-      <img src="https://contrib.rocks/image?repo=roboflow/supervision" />
+    <a href="https://github.com/roboflow/superiorvision/graphs/contributors">
+      <img src="https://contrib.rocks/image?repo=roboflow/superiorvision" />
     </a>
 </p>

{superiorvision-0.30.0.dev0 → superiorvision-0.30.0.dev2}/pyproject.toml RENAMED Viewed

@@ -4,7 +4,7 @@ requires = [ "setuptools>=61" ]
 [project]
 name = "superiorvision"
-version = "0.30.0.dev"
+version = "0.30.0.dev2"
 description = "A tensor-native, inference-focused fork of Supervision"
 readme = "README.md"
 keywords = [
@@ -66,8 +66,8 @@ optional-dependencies.metrics = [
   "pandas>=2",
 ]
 urls.Documentation = "https://supervision.roboflow.com/latest/"
-urls.Homepage = "https://github.com/roboflow/supervision"
-urls.Repository = "https://github.com/roboflow/supervision"
+urls.Homepage = "https://github.com/roboflow/superiorvision"
+urls.Repository = "https://github.com/roboflow/superiorvision"
 [dependency-groups]
 dev = [

{superiorvision-0.30.0.dev0 → superiorvision-0.30.0.dev2/src/superiorvision.egg-info}/PKG-INFO RENAMED Viewed

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: superiorvision
-Version: 0.30.0.dev0
+Version: 0.30.0.dev2
 Summary: A tensor-native, inference-focused fork of Supervision
 Author-email: "Roboflow et al." <develop@roboflow.com>
 Maintainer-email: Piotr Skalski <piotr@roboflow.com>
 License-Expression: MIT
 Project-URL: Documentation, https://supervision.roboflow.com/latest/
-Project-URL: Homepage, https://github.com/roboflow/supervision
-Project-URL: Repository, https://github.com/roboflow/supervision
+Project-URL: Homepage, https://github.com/roboflow/superiorvision
+Project-URL: Repository, https://github.com/roboflow/superiorvision
 Keywords: AI,deep-learning,DL,machine-learning,ML,Roboflow,vision
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
@@ -72,18 +72,14 @@ If detections begin as tensors, converting them to NumPy so the next operation
 can turn them back into tensors is not "compatibility." It is cardio.
 SuperiorVision declines the workout.
-[![version](https://badge.fury.io/py/supervision.svg)](https://badge.fury.io/py/supervision) [![downloads](https://img.shields.io/pypi/dm/supervision)](https://pypistats.org/packages/supervision) [![license](https://img.shields.io/pypi/l/supervision)](LICENSE.md) [![python-version](https://img.shields.io/pypi/pyversions/supervision)](https://badge.fury.io/py/supervision) [![codecov](https://codecov.io/gh/roboflow/supervision/graph/badge.svg?token=HMNJ5FVZ36)](https://codecov.io/gh/roboflow/supervision)
+[![version](https://img.shields.io/pypi/v/superiorvision)](https://pypi.org/project/superiorvision/) [![downloads](https://img.shields.io/pypi/dm/superiorvision)](https://pypistats.org/packages/superiorvision) [![license](https://img.shields.io/pypi/l/superiorvision)](LICENSE.md) [![python-version](https://img.shields.io/pypi/pyversions/superiorvision)](https://pypi.org/project/superiorvision/)
-[![snyk](https://snyk.io/advisor/python/supervision/badge.svg)](https://snyk.io/advisor/python/supervision) [![colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/roboflow/supervision/blob/main/demo.ipynb) [![gradio](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-blue)](https://huggingface.co/spaces/Roboflow/Annotators) [![discord](https://img.shields.io/discord/1159501506232451173?logo=discord&label=discord&labelColor=fff&color=5865f2&link=https%3A%2F%2Fdiscord.gg%2FGbfgXGJ8Bk)](https://discord.gg/GbfgXGJ8Bk)
-<div align="center">
-    <a href="https://trendshift.io/repositories/124"  target="_blank"><img src="https://trendshift.io/api/badge/repositories/124" alt="roboflow%2Fsupervision | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
-  </div>
+[![gradio](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-blue)](https://huggingface.co/spaces/Roboflow/Annotators) [![discord](https://img.shields.io/discord/1159501506232451173?logo=discord&label=discord&labelColor=fff&color=5865f2&link=https%3A%2F%2Fdiscord.gg%2FGbfgXGJ8Bk)](https://discord.gg/GbfgXGJ8Bk)
 Same API. Fewer NumPy vacations.
 For the external multi-object trackers used by Inference, pair SuperiorVision
-with the private [Tracktors](https://github.com/roboflow/tracktors) fork. The
+with the [Tracktors](https://pypi.org/project/tracktors/) package. The
 dependency points one way—Tracktors consumes tensor-native `sv.Detections`—so
 SuperiorVision keeps its existing `sv.ByteTrack` compatibility API without a
 circular package dependency.
@@ -98,7 +94,7 @@ circular package dependency.
     - [Annotators](#annotators)
     - [Datasets](#datasets)
 - [🎬 Tutorials](#-tutorials)
-- [💜 Built with Supervision](#-built-with-supervision)
+- [💜 Built with the API](#-built-with-the-api)
 - [📚 Documentation](#-documentation)
 - [🏆 Contribution](#-contribution)
@@ -106,11 +102,22 @@ circular package dependency.
 ## 👋 Hello
-**We are your essential toolkit for computer vision.** From data loading to real-time zone counting, we provide the building blocks so you can focus on building applications around your models. 🤝
+**The familiar computer-vision toolkit, now with fewer surprise trips to the
+CPU.** From tensor-native detections to real-time zone counting, SuperiorVision
+keeps the compatible building blocks used by Inference while letting GPUs do
+the job they were purchased to do. 🤝
 ## 💻 Install
-Pip install the supervision package in a [**Python>=3.10**](https://www.python.org/) environment.
+Install the SuperiorVision distribution in a
+[**Python>=3.10**](https://www.python.org/) environment. The published version
+is currently a development release, so pin it explicitly:
+```bash
+pip install superiorvision==0.30.0.dev2
+```
+For an editable checkout:
 ```bash
 git clone git@github.com:roboflow/superiorvision.git
@@ -125,9 +132,10 @@ import supervision as sv       # existing Inference code
 import superiorvision as sv    # cheekier spelling, same API
 ```
-Because SuperiorVision provides the `supervision` namespace, install it as a
-replacement for upstream Supervision, not beside it. Two packages cannot both
-own the same trench coat and pretend everything is fine.
+The PyPI distribution is named `superiorvision`, but it intentionally provides
+the `supervision` import namespace for drop-in compatibility. Install it as a
+replacement for upstream Supervision, not beside it. Two distributions cannot
+both own the same trench coat and pretend everything is fine.
 The upstream documentation below remains useful for the compatible API surface.
@@ -135,7 +143,7 @@ The upstream documentation below remains useful for the compatible API surface.
 ### Models
-Supervision was designed to be model agnostic. Just plug in any classification, detection, or segmentation model. For your convenience, we have created [connectors](https://supervision.roboflow.com/latest/detection/core/#detections) for the most popular libraries like Ultralytics, Transformers, MMDetection, or Inference. Other integrations, like `rfdetr`, already return `sv.Detections` directly.
+SuperiorVision preserves Supervision's model-agnostic API. Just plug in any classification, detection, or segmentation model. The compatible [connectors](https://supervision.roboflow.com/latest/detection/core/#detections) cover popular libraries such as Ultralytics, Transformers, MMDetection, and Inference. Other integrations, including `rfdetr`, already return `sv.Detections` directly.
 Install the optional dependencies for this example with `pip install pillow rfdetr`.
@@ -177,7 +185,7 @@ len(detections)
 ### Annotators
-Supervision offers a wide range of highly customizable [annotators](https://supervision.roboflow.com/latest/detection/annotators/), allowing you to compose the perfect visualization for your use case.
+SuperiorVision retains the wide range of customizable [annotators](https://supervision.roboflow.com/latest/detection/annotators/) from its upstream API, allowing you to compose the visualization your use case needs.
 ```python
 import cv2
@@ -195,7 +203,7 @@ https://github.com/roboflow/supervision/assets/26109316/691e219c-0565-4403-9218-
 ### Datasets
-Supervision provides a set of [utils](https://supervision.roboflow.com/latest/datasets/core/) that allow you to load, split, merge, and save datasets in one of the supported formats.
+SuperiorVision retains the compatible [dataset utilities](https://supervision.roboflow.com/latest/datasets/core/) for loading, splitting, merging, and saving supported formats. Dataset and image I/O remain deliberate CPU boundaries; tensor-native runtime paths do not need to cosplay as JPEG encoders.
 ```python
 import supervision as sv
@@ -309,7 +317,7 @@ for path, image, annotation in ds:
 ## 🎬 Tutorials
-Want to learn how to use Supervision? Explore our [how-to guides](https://supervision.roboflow.com/develop/how_to/detect_and_annotate/), [end-to-end examples](./examples), [cheatsheet](https://roboflow.github.io/cheatsheet-supervision/), and [cookbooks](https://supervision.roboflow.com/develop/cookbooks/)!
+Want to learn the compatible API? Explore the upstream [how-to guides](https://supervision.roboflow.com/develop/how_to/detect_and_annotate/), [end-to-end examples](./examples), [cheatsheet](https://roboflow.github.io/cheatsheet-supervision/), and [cookbooks](https://supervision.roboflow.com/develop/cookbooks/)!
 <br/>
@@ -327,9 +335,9 @@ Want to learn how to use Supervision? Explore our [how-to guides](https://superv
 <div><strong>Created: 11 Jan 2024</strong></div>
 <br/>Learn how to track and estimate the speed of vehicles using YOLO, ByteTrack, and Roboflow Inference. This comprehensive tutorial covers object detection, multi-object tracking, filtering detections, perspective transformation, speed estimation, visualization improvements, and more.</p>
-## 💜 Built with Supervision
+## 💜 Built with the API
-Did you build something cool using supervision? [Let us know!](https://github.com/roboflow/supervision/discussions/categories/built-with-supervision)
+Did you build something cool using the compatible `supervision` API? [Tell us in the SuperiorVision repository.](https://github.com/roboflow/superiorvision)
 https://user-images.githubusercontent.com/26109316/207858600-ee862b22-0353-440b-ad85-caa0c4777904.mp4
@@ -339,15 +347,15 @@ https://github.com/roboflow/supervision/assets/26109316/3ac6982f-4943-4108-9b7f-
 ## 📚 Documentation
-Visit our [documentation](https://roboflow.github.io/supervision) page to learn how supervision can help you build computer vision applications faster and more reliably.
+The [upstream Supervision documentation](https://supervision.roboflow.com/latest/) describes the compatible API. Fork-specific tensor coverage and Inference compatibility are tracked in [this repository](https://github.com/roboflow/superiorvision) and [the Inference API surface audit](INFERENCE_API_SURFACE.md).
 ## 🏆 Contribution
-We love your input! Please see our [contributing guide](.github/CONTRIBUTING.md) to get started. Thank you 🙏 to all our contributors!
+We love your input! Please see our [contributing guide](.github/CONTRIBUTING.md) to get started. The fork lives at [`roboflow/superiorvision`](https://github.com/roboflow/superiorvision); upstream-compatible changes may still belong in Supervision. Thank you 🙏 to all our contributors!
 <p align="center">
-    <a href="https://github.com/roboflow/supervision/graphs/contributors">
-      <img src="https://contrib.rocks/image?repo=roboflow/supervision" />
+    <a href="https://github.com/roboflow/superiorvision/graphs/contributors">
+      <img src="https://contrib.rocks/image?repo=roboflow/superiorvision" />
     </a>
 </p>

{superiorvision-0.30.0.dev0 → superiorvision-0.30.0.dev2}/src/supervision/detection/core.py RENAMED Viewed

@@ -63,9 +63,6 @@ from supervision.detection.utils.iou_and_nms import (
 from supervision.detection.utils.iou_and_nms import (
     box_non_max_merge as numpy_box_non_max_merge,
 )
-from supervision.detection.utils.iou_and_nms import (
-    box_non_max_suppression as numpy_box_non_max_suppression,
-)
 from supervision.detection.utils.iou_and_nms import (
     mask_non_max_merge as numpy_mask_non_max_merge,
 )
@@ -784,7 +781,7 @@ class Detections:
     @classmethod
     def from_transformers(
         cls,
-        transformers_results: dict[str, Any],
+        transformers_results: Any,
         id2label: dict[int, str] | None = None,
     ) -> Detections:
         """
@@ -2961,7 +2958,10 @@ class Detections:
         ):
             index = [int(index)]
         tensor_index = _index_for_device(index, self.xyxy.device)
-        host_index = _index_for_host(index)
+        needs_host_index = isinstance(self.mask, CompactMask) or any(
+            not isinstance(value, torch.Tensor) for value in self.data.values()
+        )
+        host_index = _index_for_host(index) if needs_host_index else index
         data: _DetectionDataType = {}
         for key, value in self.data.items():
             if isinstance(value, torch.Tensor):
@@ -3329,10 +3329,7 @@ class Detections:
             )
         if self.mask is not None:
-            if (
-                isinstance(self.mask, torch.Tensor)
-                and overlap_metric == OverlapMetric.IOU
-            ):
+            if isinstance(self.mask, torch.Tensor):
                 indices = tensor_mask_non_max_suppression(
                     predictions=predictions,
                     masks=self.mask,
@@ -3359,18 +3356,12 @@ class Detections:
                 iou_threshold=threshold,
                 overlap_metric=overlap_metric,
             )
-        elif overlap_metric == OverlapMetric.IOU:
+        else:
             indices = tensor_box_non_max_suppression(
                 predictions=predictions,
                 iou_threshold=threshold,
                 overlap_metric=overlap_metric,
             )
-        else:
-            indices = numpy_box_non_max_suppression(
-                predictions=to_numpy(predictions),
-                iou_threshold=threshold,
-                overlap_metric=overlap_metric,
-            )
         return self.select(indices)

{superiorvision-0.30.0.dev0 → superiorvision-0.30.0.dev2}/src/supervision/detection/overlap_filter.py RENAMED Viewed

@@ -10,6 +10,40 @@ import torch
 from supervision.detection.utils import box_iou_batch, mask_iou_batch
+def _uses_intersection_over_smaller(overlap_metric: object | None) -> bool:
+    """Return whether an overlap metric requests intersection over smaller area."""
+    value = getattr(overlap_metric, "value", overlap_metric)
+    return isinstance(value, str) and value.lower() == "ios"
+def _tensor_mask_overlap_batch(
+    masks: torch.Tensor, overlap_metric: object | None
+) -> torch.Tensor:
+    """Compute pairwise tensor mask overlap without leaving the source device."""
+    flat_masks = masks.bool().flatten(1)
+    intersection = (flat_masks[:, None] & flat_masks[None, :]).sum(dim=2)
+    areas = flat_masks.sum(dim=1)
+    if _uses_intersection_over_smaller(overlap_metric):
+        denominator = torch.minimum(areas[:, None], areas[None, :])
+    else:
+        denominator = areas[:, None] + areas[None, :] - intersection
+    return intersection / denominator.clamp(min=1)
+def _tensor_box_overlap_batch(
+    boxes: torch.Tensor, overlap_metric: object | None
+) -> torch.Tensor:
+    """Compute pairwise tensor box overlap without leaving the source device."""
+    if not _uses_intersection_over_smaller(overlap_metric):
+        return box_iou_batch(boxes, boxes)
+    areas = (boxes[:, 2] - boxes[:, 0]) * (boxes[:, 3] - boxes[:, 1])
+    top_left = torch.maximum(boxes[:, None, :2], boxes[:, :2])
+    bottom_right = torch.minimum(boxes[:, None, 2:], boxes[:, 2:])
+    intersection = (bottom_right - top_left).clamp(min=0).prod(dim=2)
+    denominator = torch.minimum(areas[:, None], areas[None, :])
+    return torch.nan_to_num(intersection / denominator)
 def resize_masks(masks: np.ndarray, max_dimension: int = 640) -> np.ndarray:
     """
     Resize all masks in the array to have a maximum dimension of max_dimension,
@@ -86,16 +120,15 @@ def mask_non_max_suppression(
         # Pairwise mask IoU without leaving the source device. This is intentionally
         # exact; callers wanting a reduced-resolution approximation can downsample
         # the masks before constructing Detections.
-        flat_masks = sorted_masks.bool().flatten(1)
-        intersection = (flat_masks[:, None] & flat_masks[None, :]).sum(dim=2)
-        areas = flat_masks.sum(dim=1)
-        ious = intersection / (areas[:, None] + areas[None, :] - intersection).clamp(min=1)
+        ious = _tensor_mask_overlap_batch(sorted_masks, overlap_metric)
         categories = sorted_predictions[:, 5]
         keep = torch.ones(rows, dtype=torch.bool, device=predictions.device)
         for index in range(rows):
-            if not keep[index]:
-                continue
-            suppress = (ious[index] > iou_threshold) & (categories == categories[index])
+            suppress = (
+                (ious[index] > iou_threshold)
+                & (categories == categories[index])
+                & keep[index]
+            )
             suppress[index] = False
             keep &= ~suppress
         output = torch.zeros(rows, dtype=torch.bool, device=predictions.device)
@@ -159,12 +192,14 @@ def box_non_max_suppression(
         sort_index = torch.argsort(predictions[:, 4], descending=True)
         sorted_predictions = predictions[sort_index]
         boxes, categories = sorted_predictions[:, :4], sorted_predictions[:, 5]
-        ious = box_iou_batch(boxes, boxes)
+        ious = _tensor_box_overlap_batch(boxes, overlap_metric)
         keep = torch.ones(rows, dtype=torch.bool, device=predictions.device)
         for index in range(rows):
-            if not keep[index]:
-                continue
-            suppress = (ious[index] > iou_threshold) & (categories == categories[index])
+            suppress = (
+                (ious[index] > iou_threshold)
+                & (categories == categories[index])
+                & keep[index]
+            )
             suppress[index] = False
             keep &= ~suppress
         output = torch.zeros(rows, dtype=torch.bool, device=predictions.device)

superiorvision 0.30.0.dev0__tar.gz → 0.30.0.dev2__tar.gz

superiorvision 0.30.0.dev0tar.gz → 0.30.0.dev2tar.gz