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.40.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.40.0
File Size Uploaded Provenance Actions
edgefirst_tracker-0.40.0.tar.gz 2.9 MB With provenance Details for edgefirst_tracker-0.40.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for edgefirst-tracker 0.40.0
File Actions
edgefirst_tracker-0.40.0-cp311-abi3-win_amd64.whl CPython 3.11 abi3 Windows x86-64 Details for edgefirst_tracker-0.40.0-cp311-abi3-win_amd64.whl
edgefirst_tracker-0.40.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.40.0-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
edgefirst_tracker-0.40.0-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl CPython 3.11 abi3 Linux glibc 2.17+ ARM64 Details for edgefirst_tracker-0.40.0-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
edgefirst_tracker-0.40.0-cp311-abi3-macosx_11_0_arm64.whl CPython 3.11 abi3 macOS 11.0+ ARM64 Details for edgefirst_tracker-0.40.0-cp311-abi3-macosx_11_0_arm64.whl
edgefirst_tracker-0.40.0-cp38-abi3-win_amd64.whl CPython 3.8 abi3 Windows x86-64 Details for edgefirst_tracker-0.40.0-cp38-abi3-win_amd64.whl
edgefirst_tracker-0.40.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.40.0-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
edgefirst_tracker-0.40.0-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl CPython 3.8 abi3 Linux glibc 2.17+ ARM64 Details for edgefirst_tracker-0.40.0-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
edgefirst_tracker-0.40.0-cp38-abi3-macosx_11_0_arm64.whl CPython 3.8 abi3 macOS 11.0+ ARM64 Details for edgefirst_tracker-0.40.0-cp38-abi3-macosx_11_0_arm64.whl

Total release size: 5.7 MB

Release files / edgefirst_tracker-0.40.0.tar.gz

Download URL edgefirst_tracker-0.40.0.tar.gz
Size 2.9 MB
Tags Source
SHA-256 checksum
How to use checksums
915ae766ade039eae06946da82683690d1e1ab04a4525a385670bbf4a7e5d616
BLAKE2b-256 checksum
How to use checksums
7210877d748c410b2bcbb762556d744f49ef20f4c710d74ba0db25d2167e2a29
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 5, 2026.

Transparency log

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

Download URL edgefirst_tracker-0.40.0-cp311-abi3-win_amd64.whl
Size 291.6 kB
Tags CPython 3.11 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
d1d6fb11f62a7c1c39367c79f73ff9332c73e84d07bb9257b749f050e7fc6282
BLAKE2b-256 checksum
How to use checksums
b6ada433ad9cd6959169c2fb6b65ab021fdf19a3356c5a9295f70909f2d94af9
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 5, 2026.

Transparency log

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

Download URL edgefirst_tracker-0.40.0-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 360.3 kB
Tags CPython 3.11 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
dc640a67b67147a4dc86b66195eea3ab87a50f5bd6036ead25d18fc4992a6d2b
BLAKE2b-256 checksum
How to use checksums
55d2677709f0da4dd611a8451dab876de256c837a9904311bd7243bec22f40a3
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 5, 2026.

Transparency log

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

Download URL edgefirst_tracker-0.40.0-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 364.1 kB
Tags CPython 3.11 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum
How to use checksums
6ee36006d4a36fcf519fbcfeedcf99b6edce3526fdb71b3c1cef8a130762f2a6
BLAKE2b-256 checksum
How to use checksums
641ff0921353e0f502a5576dcc46f70b0a2e7fb3980c61c2dffcb6b87683da39
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 5, 2026.

Transparency log

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

Download URL edgefirst_tracker-0.40.0-cp311-abi3-macosx_11_0_arm64.whl
Size 377.5 kB
Tags CPython 3.11 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
5d9e17585dbee23b0b0c62db3b770d5589fe8d2f261f05be043feddf5ea63220
BLAKE2b-256 checksum
How to use checksums
1a8980d4cdb2f143c7034859421942e5a5da0c79a8ec88a3031d095473738662
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 5, 2026.

Transparency log

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

Download URL edgefirst_tracker-0.40.0-cp38-abi3-win_amd64.whl
Size 296.8 kB
Tags CPython 3.8 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
a88da246add2aba58272bc3b4e35e0a7e512b1bc4a1ef480b5e24b526915c074
BLAKE2b-256 checksum
How to use checksums
1c6367df597ae18ef189fc99912fc7c67760c48a26881ce989a27ac1f7a1a3c4
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 5, 2026.

Transparency log

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

Download URL edgefirst_tracker-0.40.0-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 383.7 kB
Tags CPython 3.8 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
c7eee0ef3790132449f53ab81a1c2c2a403f05b9c2c4196bd9a2cbf5e4629fb6
BLAKE2b-256 checksum
How to use checksums
ac542e34f587b103479cef91636fc8b49313a99ca7e5d046d7f7611512b50d69
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 5, 2026.

Transparency log

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

Download URL edgefirst_tracker-0.40.0-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 368.3 kB
Tags CPython 3.8 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum
How to use checksums
d6d38632aa8e95ddcbd82d3e9211cb815dc0fd5cd765d03a533c0324b7dc6565
BLAKE2b-256 checksum
How to use checksums
6f3d3daf9033d79294ad444e53aa2ff71df2e61d0440eb5fc4046ade7debcd1e
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 5, 2026.

Transparency log

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

Download URL edgefirst_tracker-0.40.0-cp38-abi3-macosx_11_0_arm64.whl
Size 382.5 kB
Tags CPython 3.8 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
8ca8fe6940cc41c63e27dba70630e2d48131c512d527bfd316a14767eabd9423
BLAKE2b-256 checksum
How to use checksums
850ddf5eebb1202ffd220ab3b57b442a37ab5cb43500b336642c78972b40bb7e
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 5, 2026.

Transparency log

Security for edgefirst-tracker 0.40.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.40.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 5, 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