edgefirst-tracker

ByteTrack multi-object tracking. Installs alone — it does not require the tensor, image, or decoder wheels.

Part of the EdgeFirst HAL

edgefirst-tracker is one of five Python packages built from the EdgeFirst Hardware Abstraction Layer.

The EdgeFirstAI/hal repository is the home for all of them — source, issue tracker, architecture documentation and release notes.

Installation

pip install edgefirst-tracker

Requires Python 3.8 or newer and NumPy. Wheels are published for Linux (x86_64, aarch64), macOS (arm64), and Windows (x86_64). This package does not depend on edgefirst-tensor.

Packages install under the PEP 420 edgefirst.* namespace, so the import is edgefirst.tracker.

Quick start

ByteTrack.update takes detections for one timestamp and returns a list of TrackInfo (or None for unmatched rows) of the same length as the input:

import numpy as np
from edgefirst.tracker import ByteTrack

tracker = ByteTrack()

# boxes is (N, 4) XYXY; scores and labels are length N.
boxes = np.array([[0.1, 0.2, 0.3, 0.4]], dtype=np.float32)
scores = np.array([0.9], dtype=np.float32)
labels = np.array([0], dtype=np.intp)
timestamp_ns = 0

tracks = tracker.update(boxes, scores, labels, timestamp_ns)
for t in tracks:
    if t is None:
        continue
    print(t.uuid, t.tracked_location, t.count)

Decoder.decode_tracked on the edgefirst-decoder wheel accepts this ByteTrack (or any object with an update method).

Parameters

Errors

update raises if boxes, scores, and labels disagree on N, or if boxes is not shape (N, 4). Empty detections (N == 0) are valid — unmatched tracks age and expire according to lifespan_ns.

Performance

Association is CPU-only (Kalman + IoU). Typical cost is microseconds per frame at tens of detections; it does not allocate GPU tensors and does not link libedgefirst_tensor. Build the tracker once and call update every frame.

Versioning and changelog

All five edgefirst-* packages are versioned and released together with the HAL itself. Release notes live in the single CHANGELOG.md.

Links

• Changelog — release notes for all packages
• Source — the hal monorepo
• Issue tracker
• Package documentation — the underlying Rust crate
• EdgeFirst

License

Apache-2.0