feat/core: BoT-SORT block (#2349)

* initial commit for BoTSORT block

* added botsort to overview doc

---------

Co-authored-by: Paweł Pęczek <146137186+PawelPeczek-Roboflow@users.noreply.github.com>

Author: AlexBodner

docs/workflows/video_processing/overview.md

@@ -1,7 +1,7 @@
 # Video Processing with Workflows
 
 We've begun our journey into video processing using Workflows. Over time, we've expanded the number of
-video-specific blocks — including object tracker blocks for **ByteTrack**, **SORT**, and **OC-SORT** — and
+video-specific blocks — including object tracker blocks for **ByteTrack**, **SORT**, **OC-SORT** and **BoT-SORT** — and
 continue to dedicate efforts toward improving their performance and robustness. The current state of this
 work is as follows:
 

inference/core/workflows/core_steps/loader.py

@@ -453,6 +453,9 @@
     TwilioSMSNotificationBlockV2,
 )
 from inference.core.workflows.core_steps.sinks.webhook.v1 import WebhookSinkBlockV1
+from inference.core.workflows.core_steps.trackers.botsort.v1 import (
+    BoTSORTBlockV1 as TrackerBoTSORTBlockV1,
+)
 from inference.core.workflows.core_steps.trackers.bytetrack.v1 import (
     ByteTrackBlockV1 as TrackerByteTrackBlockV1,
 )
@@ -919,6 +922,7 @@ def load_blocks() -> List[Type[WorkflowBlock]]:
         ReferencePathVisualizationBlockV1,
         ByteTrackerBlockV3,
         TrackerByteTrackBlockV1,
+        TrackerBoTSORTBlockV1,
         TrackerSORTBlockV1,
         TrackerOCSORTBlockV1,
         WebhookSinkBlockV1,

inference/core/workflows/core_steps/trackers/_base.py

@@ -1,13 +1,14 @@
 """Shared base classes for tracker workflow blocks.
 
-Each concrete tracker block (ByteTrack, SORT, OC-SORT) inherits from
-``TrackerBlockBase`` and only needs to implement ``_create_tracker`` and
-``get_manifest``.
+Each concrete tracker block (ByteTrack, BoT-SORT, SORT, OC-SORT) inherits from
+``TrackerBlockBase`` and implements ``_create_tracker`` and ``get_manifest``.
+Sub-classes may override ``_tracker_update`` when the underlying tracker needs
+extra per-frame context (e.g. a video frame for camera motion compensation).
 """
 
 from abc import abstractmethod
 from collections import deque
-from typing import Any, Dict, List, Optional, Type
+from typing import Any, Dict, List, Type
 
 import supervision as sv
 
@@ -76,7 +77,9 @@ def _cache_new_tracker_id(self, tracker_id: int) -> None:
 class TrackerBlockBase(WorkflowBlock):
     """Common run-loop shared by every tracker block.
 
-    Sub-classes only need to override ``_create_tracker`` and ``get_manifest``.
+    Sub-classes implement ``_create_tracker`` and ``get_manifest``.  Override
+    ``_tracker_update`` only when the tracker API requires additional context
+    beyond ``sv.Detections`` (e.g. BoT-SORT with camera motion compensation).
     """
 
     def __init__(self) -> None:
@@ -92,6 +95,20 @@ def _create_tracker(self, fps: int, **kwargs: Any) -> Any:
         """Instantiate the concrete tracker with algorithm-specific params."""
         ...
 
+    def _tracker_update(
+        self,
+        tracker: Any,
+        detections: sv.Detections,
+        image: WorkflowImageData,
+    ) -> sv.Detections:
+        """Invoke the tracker for one frame.
+
+        Must call ``tracker.update`` only with arguments that library trackers
+        define for the per-frame step (typically detections, optionally a frame
+        tensor).  Do **not** pass workflow/block kwargs used in ``_create_tracker``.
+        """
+        return tracker.update(detections)
+
     def _run_tracker(
         self,
         image: WorkflowImageData,
@@ -120,7 +137,7 @@ def _run_tracker(
             self._trackers[video_id] = self._create_tracker(fps=fps, **tracker_kwargs)
 
         tracker = self._trackers[video_id]
-        tracked_detections = tracker.update(detections)
+        tracked_detections = self._tracker_update(tracker, detections, image)
 
         # Filter out immature / unmatched tracks (tracker_id == -1)
         if tracked_detections.tracker_id is not None and len(tracked_detections) > 0: