Skip to main content

edgefirst-tracker

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

PyPI License

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.

Package Provides
edgefirst-tensor Zero-copy tensor allocation and host/GPU/CUDA mapping
edgefirst-codec JPEG and PNG decoding directly into pre-allocated tensors
edgefirst-image GPU-accelerated colour conversion, resize, letterbox, tiling and drawing
edgefirst-decoder YOLO and ModelPack output decoding
edgefirst-tracker ByteTrack (this package)

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

Argument Default Meaning
high_conf 0.7 Detections above this score take the first association pass
iou 0.25 IoU gate for matching a detection to a track
update 0.25 Kalman update blending factor
lifespan_ns 500_000_000 Drop a track that has not matched for this many nanoseconds (500 ms)

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.

License

Apache-2.0

Metadata

Release files for edgefirst-tracker 0.41.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for edgefirst-tracker 0.41.0
File Size Uploaded Provenance Actions
edgefirst_tracker-0.41.0.tar.gz 2.4 MB With provenance Details for edgefirst_tracker-0.41.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for edgefirst-tracker 0.41.0
File Actions
edgefirst_tracker-0.41.0-cp311-abi3-win_amd64.whl CPython 3.11 abi3 Windows x86-64 Details for edgefirst_tracker-0.41.0-cp311-abi3-win_amd64.whl
edgefirst_tracker-0.41.0-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl CPython 3.11 abi3 Linux glibc 2.17+ x86-64 Details for edgefirst_tracker-0.41.0-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
edgefirst_tracker-0.41.0-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl CPython 3.11 abi3 Linux glibc 2.17+ ARM64 Details for edgefirst_tracker-0.41.0-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
edgefirst_tracker-0.41.0-cp311-abi3-macosx_11_0_arm64.whl CPython 3.11 abi3 macOS 11.0+ ARM64 Details for edgefirst_tracker-0.41.0-cp311-abi3-macosx_11_0_arm64.whl
edgefirst_tracker-0.41.0-cp38-abi3-win_amd64.whl CPython 3.8 abi3 Windows x86-64 Details for edgefirst_tracker-0.41.0-cp38-abi3-win_amd64.whl
edgefirst_tracker-0.41.0-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl CPython 3.8 abi3 Linux glibc 2.17+ x86-64 Details for edgefirst_tracker-0.41.0-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
edgefirst_tracker-0.41.0-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl CPython 3.8 abi3 Linux glibc 2.17+ ARM64 Details for edgefirst_tracker-0.41.0-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
edgefirst_tracker-0.41.0-cp38-abi3-macosx_11_0_arm64.whl CPython 3.8 abi3 macOS 11.0+ ARM64 Details for edgefirst_tracker-0.41.0-cp38-abi3-macosx_11_0_arm64.whl

Total release size: 5.2 MB

Release files / edgefirst_tracker-0.41.0.tar.gz

Download URL edgefirst_tracker-0.41.0.tar.gz
Size 2.4 MB
Tags Source
SHA-256 checksum
How to use checksums
f4684a169dd5c03eaa991ff2d7dd8b8d490e2ab154a602a158850a45f68e5eba
BLAKE2b-256 checksum
How to use checksums
5f24aca46ac3e3da1d4a275eb4c15c67fcdfc82bc152a806d8278ed1ada6f48d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / edgefirst_tracker-0.41.0-cp311-abi3-win_amd64.whl

Download URL edgefirst_tracker-0.41.0-cp311-abi3-win_amd64.whl
Size 290.6 kB
Tags CPython 3.11 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
23d5fba3753978130c88abcb302e1a5b6d5e7c305303c0fccf26e10f8c4e600e
BLAKE2b-256 checksum
How to use checksums
da45e3c64142e1b83f357a81fd0300216e3e95d67a6c29b250c5d9aca8a06e98
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / edgefirst_tracker-0.41.0-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL edgefirst_tracker-0.41.0-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 359.4 kB
Tags CPython 3.11 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
7b184045b12469740be674714c29cb469eabc3903f016a83a981b78c7c4fc811
BLAKE2b-256 checksum
How to use checksums
d6c0276a42b6316b9ef73b098968df126e397f48a67f15f1d36d3d00e22e271b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / edgefirst_tracker-0.41.0-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL edgefirst_tracker-0.41.0-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 363.1 kB
Tags CPython 3.11 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum
How to use checksums
ca8b99281e7d22242fa009335c7b1373807a5deada1a5a92a69865694d0db268
BLAKE2b-256 checksum
How to use checksums
45d367a1a7d416d06b56eff622ce54e51aa948196a3fa931ccd33a50355933e0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / edgefirst_tracker-0.41.0-cp311-abi3-macosx_11_0_arm64.whl

Download URL edgefirst_tracker-0.41.0-cp311-abi3-macosx_11_0_arm64.whl
Size 376.1 kB
Tags CPython 3.11 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
0e68edc5f2c573a926753d4a2c8136006e6b7f7e574d0c3b7c2491e7cf1963a7
BLAKE2b-256 checksum
How to use checksums
c12e773196480da471f0037d60d946836823a1e788627d2bc79180e7b50bf3f3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / edgefirst_tracker-0.41.0-cp38-abi3-win_amd64.whl

Download URL edgefirst_tracker-0.41.0-cp38-abi3-win_amd64.whl
Size 295.6 kB
Tags CPython 3.8 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
d8a9d7e2b41e45609956942702a30c1418660bf02454b7487df60ae5a3258a99
BLAKE2b-256 checksum
How to use checksums
2b19e8271617da6a4194903b2b523e2774922c21271f3a49f14a3b7160090f1b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / edgefirst_tracker-0.41.0-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL edgefirst_tracker-0.41.0-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 382.4 kB
Tags CPython 3.8 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
58ce9a68db8646f8794621f0601646b10d5505aa430dff8ad3a712d25036ad54
BLAKE2b-256 checksum
How to use checksums
551f23c0e24c4b349e74127720b2eec9a0fe97c7703fe2f21a455c7687ddde3c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / edgefirst_tracker-0.41.0-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL edgefirst_tracker-0.41.0-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 367.2 kB
Tags CPython 3.8 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum
How to use checksums
effcbbe703855f50bb292944c3819cf0e5ea1b62a44678c53d17e8d129d2f6ca
BLAKE2b-256 checksum
How to use checksums
8626dea91d7ff4d1e0aee038f8766cf92a9a2e67d94c620a0cccb29b77aff19e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / edgefirst_tracker-0.41.0-cp38-abi3-macosx_11_0_arm64.whl

Download URL edgefirst_tracker-0.41.0-cp38-abi3-macosx_11_0_arm64.whl
Size 381.1 kB
Tags CPython 3.8 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
6ec05736311c67eef0a8255f762e0501c637f467d6aeaa51155bcdcf616f2b10
BLAKE2b-256 checksum
How to use checksums
3e89569b5e48723af627c01f255de136c70d99aa25053df44b5b5fd75253ebf6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Security for edgefirst-tracker 0.41.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 9 files in this release have been uploaded with provenance metadata.

Select from 9 files

Attestation for edgefirst_tracker-0.41.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page