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.

Links

License

Apache-2.0

Project links

Data verified by PyPI on Sep 8, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for au-zone from gravatar.com au-zone

Credits

PyPI data
Data sourced directly from PyPI's database.

Author: Au-Zone Technologies

GitHub Statistics

Data verified by PyPI on Sep 8, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

Apache-2.0
View SPDX License List

Requires

Python >=3.8

Tags

tracking bytetrack object-tracking kalman-filter edge-ai

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

edgefirst_tracker-0.30.0.tar.gz (1.9 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

edgefirst_tracker-0.30.0-cp311-abi3-win_amd64.whl (312.4 kB view details)

Uploaded CPython 3.11+Windows x86-64

edgefirst_tracker-0.30.0-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (389.6 kB view details)

Uploaded CPython 3.11+manylinux: glibc 2.17+ x86-64

edgefirst_tracker-0.30.0-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (394.2 kB view details)

Uploaded CPython 3.11+manylinux: glibc 2.17+ ARM64

edgefirst_tracker-0.30.0-cp311-abi3-macosx_11_0_arm64.whl (365.3 kB view details)

Uploaded CPython 3.11+macOS 11.0+ ARM64

edgefirst_tracker-0.30.0-cp38-abi3-win_amd64.whl (316.0 kB view details)

Uploaded CPython 3.8+Windows x86-64

edgefirst_tracker-0.30.0-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (411.7 kB view details)

Uploaded CPython 3.8+manylinux: glibc 2.17+ x86-64

edgefirst_tracker-0.30.0-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (397.1 kB view details)

Uploaded CPython 3.8+manylinux: glibc 2.17+ ARM64

edgefirst_tracker-0.30.0-cp38-abi3-macosx_11_0_arm64.whl (368.8 kB view details)

Uploaded CPython 3.8+macOS 11.0+ ARM64

File details

Details for the file edgefirst_tracker-0.30.0.tar.gz.

File metadata

  • Download URL: edgefirst_tracker-0.30.0.tar.gz
  • Upload date:
  • Size: 1.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for edgefirst_tracker-0.30.0.tar.gz
Algorithm Hash digest
SHA256 59ed89e2d6c887084d4383bab5192d60552cae9a65d5dcfc5fe1b63371458d47
MD5 787d5984112a56d28d587db90948fb97
BLAKE2b-256 5283329821382b62fb2103cdb049014c31d9ba78481b1fb69deb6903c8fcb900

See more details on using hashes here.

Provenance

The following attestation bundles were made for edgefirst_tracker-0.30.0.tar.gz:

Publisher: release.yml on EdgeFirstAI/hal

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file edgefirst_tracker-0.30.0-cp311-abi3-win_amd64.whl.

File metadata

File hashes

Hashes for edgefirst_tracker-0.30.0-cp311-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 b36ef13a96888504f01f5f1e47cc2687a917e93ce89e15c4cf5e30c39101bccc
MD5 876c9bebcfd1f70e502171ffc5cb34a9
BLAKE2b-256 3ef509ec18a619e9f4c4fdb48c6b872cc1d0ad29135f0c640273013b298350e1

See more details on using hashes here.

Provenance

The following attestation bundles were made for edgefirst_tracker-0.30.0-cp311-abi3-win_amd64.whl:

Publisher: release.yml on EdgeFirstAI/hal

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file edgefirst_tracker-0.30.0-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for edgefirst_tracker-0.30.0-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 e16375e1fb39a99dc5336fd82b2632dd6d195618939725ff858f2796856a0fee
MD5 c04dfe17236a5df2758efc7f94cd1fbd
BLAKE2b-256 e7686d398e4912356129da9e34300459cc2e648793ea84e5cb6747f33ac2f1b6

See more details on using hashes here.

Provenance

The following attestation bundles were made for edgefirst_tracker-0.30.0-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release.yml on EdgeFirstAI/hal

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file edgefirst_tracker-0.30.0-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for edgefirst_tracker-0.30.0-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 0b0f969dd39394ee8658b241c866916abc80e63447b769c743353960ecdd3e3c
MD5 4b2798f26dbdd1a6591f80b9c591c628
BLAKE2b-256 048a8a5fccaf7d8cae87d7be6cf1f9a71e2b408f87230efbb141bfd64cf04b28

See more details on using hashes here.

Provenance

The following attestation bundles were made for edgefirst_tracker-0.30.0-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: release.yml on EdgeFirstAI/hal

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file edgefirst_tracker-0.30.0-cp311-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for edgefirst_tracker-0.30.0-cp311-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 923920863625f5a92390d3e1589c56b8ffb5687338e3ddddc347daa405f9cb57
MD5 e225295ff2614e2f0b64458eb25504e4
BLAKE2b-256 f5e87a6e534ce66c2cfa16a53cfb4f764490b972f6f959319a3d317911d89f93

See more details on using hashes here.

Provenance

The following attestation bundles were made for edgefirst_tracker-0.30.0-cp311-abi3-macosx_11_0_arm64.whl:

Publisher: release.yml on EdgeFirstAI/hal

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file edgefirst_tracker-0.30.0-cp38-abi3-win_amd64.whl.

File metadata

File hashes

Hashes for edgefirst_tracker-0.30.0-cp38-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 c455380a3acd2556d18c394b48efbec8e15ecc1cceba479e32c6a3c789dfc45e
MD5 d66e9b8931ae808be6ab7603b7b96f18
BLAKE2b-256 08e012e69a0b5758f6de9316ea39fa96eb95e514fd93cd81b9eb6387ffdf00f8

See more details on using hashes here.

Provenance

The following attestation bundles were made for edgefirst_tracker-0.30.0-cp38-abi3-win_amd64.whl:

Publisher: release.yml on EdgeFirstAI/hal

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file edgefirst_tracker-0.30.0-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for edgefirst_tracker-0.30.0-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 00419cc483ff1a310a27e15d6b0a0560b1de8483e3b0bb2fa8192357ca2556b6
MD5 de429205e12e06dbc53e28493b861a36
BLAKE2b-256 0792a50d22856eaeaf496fa7aef7e473704acdbfc1df5c8e908467c3482543c2

See more details on using hashes here.

Provenance

The following attestation bundles were made for edgefirst_tracker-0.30.0-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release.yml on EdgeFirstAI/hal

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file edgefirst_tracker-0.30.0-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for edgefirst_tracker-0.30.0-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 735c1ea5ca10a7b562c9c58f3e71b8b9c1a543d37b56dc071a493a4be1a1bb17
MD5 d867a0543d3484cce78dd1f0b4fbca90
BLAKE2b-256 2cc522e081e77a7ba0bcd6caeb1fb3b78fb63940f0edfc169e4b27ea70a8568c

See more details on using hashes here.

Provenance

The following attestation bundles were made for edgefirst_tracker-0.30.0-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: release.yml on EdgeFirstAI/hal

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file edgefirst_tracker-0.30.0-cp38-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for edgefirst_tracker-0.30.0-cp38-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 33a5919941b4332ab8ec941aad9c2f7ac0b96d8e358374cff852370a05159535
MD5 fe86fd8abf63184a3cdbdd70a3ceac73
BLAKE2b-256 afa3b4d2141fc15c9da5401180c543618b343077ca96c665e631487e4e4cec44

See more details on using hashes here.

Provenance

The following attestation bundles were made for edgefirst_tracker-0.30.0-cp38-abi3-macosx_11_0_arm64.whl:

Publisher: release.yml on EdgeFirstAI/hal

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.30.0 This release

9 files

0.29.4

9 files

0.29.3

9 files

Pre-release

0.29.0rc1

1 file

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