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 5, 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:
Newer release available (0.30.0)

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 5, 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.29.4.tar.gz (1.7 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.29.4-cp311-abi3-win_amd64.whl (311.4 kB view details)

Uploaded CPython 3.11+Windows x86-64

edgefirst_tracker-0.29.4-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (388.7 kB view details)

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

edgefirst_tracker-0.29.4-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (393.2 kB view details)

Uploaded CPython 3.11+manylinux: glibc 2.17+ ARM64

edgefirst_tracker-0.29.4-cp311-abi3-macosx_11_0_arm64.whl (364.3 kB view details)

Uploaded CPython 3.11+macOS 11.0+ ARM64

edgefirst_tracker-0.29.4-cp38-abi3-win_amd64.whl (315.1 kB view details)

Uploaded CPython 3.8+Windows x86-64

edgefirst_tracker-0.29.4-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (410.8 kB view details)

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

edgefirst_tracker-0.29.4-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (396.1 kB view details)

Uploaded CPython 3.8+manylinux: glibc 2.17+ ARM64

edgefirst_tracker-0.29.4-cp38-abi3-macosx_11_0_arm64.whl (367.9 kB view details)

Uploaded CPython 3.8+macOS 11.0+ ARM64

File details

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

File metadata

  • Download URL: edgefirst_tracker-0.29.4.tar.gz
  • Upload date:
  • Size: 1.7 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.29.4.tar.gz
Algorithm Hash digest
SHA256 153e4d5f205dc302b2ee6629263d8386029d968d6c31df9a5b27e081760b8b7c
MD5 c3dadf3f593a4599404098e3612e9c51
BLAKE2b-256 8b201308ad3b1a384b7472d38fb88cdedea10b6beffd901839f01a0a27072a3f

See more details on using hashes here.

Provenance

The following attestation bundles were made for edgefirst_tracker-0.29.4.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.29.4-cp311-abi3-win_amd64.whl.

File metadata

File hashes

Hashes for edgefirst_tracker-0.29.4-cp311-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 bbc4a97a664064ce370cff0319d07d5d226134857056ccc9b532c3b533fe3728
MD5 68a26c25a45195ab0897f30298753e56
BLAKE2b-256 f9ce1e019cbe038339b4d09bdb86e2e6b86a23c2961cf2f5fc5478f2176d242f

See more details on using hashes here.

Provenance

The following attestation bundles were made for edgefirst_tracker-0.29.4-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.29.4-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for edgefirst_tracker-0.29.4-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 1fedd9d078e79a3f0f3cb7a65966933179b83373e861cdf83651afe524ed5903
MD5 66480bf3d0971c64d480dffef21c4f80
BLAKE2b-256 cc011f433732c8085a642067a5a7acc2ddb16adc96eec0c6face8d7e5642252d

See more details on using hashes here.

Provenance

The following attestation bundles were made for edgefirst_tracker-0.29.4-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.29.4-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for edgefirst_tracker-0.29.4-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 27b5a0f99707246f37c754e8473d814c1c1e7667cae01748bf092aefe952448b
MD5 982f8b43e62897dc4c8ff304b19513f7
BLAKE2b-256 974e1c215e8972b0b9fdc21ae951f2cb2184a84fcf08997f30f05f6fdc365830

See more details on using hashes here.

Provenance

The following attestation bundles were made for edgefirst_tracker-0.29.4-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.29.4-cp311-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for edgefirst_tracker-0.29.4-cp311-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 50883cdb447e3eae064efb9f1810c59b3916277e63f79171b1c2fcb24429f52e
MD5 27e0e853047d3b8795073b378236cf17
BLAKE2b-256 89540147d901b3ce56570df9666806103cea5fd7595ba21068f4d05bdbb850f4

See more details on using hashes here.

Provenance

The following attestation bundles were made for edgefirst_tracker-0.29.4-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.29.4-cp38-abi3-win_amd64.whl.

File metadata

File hashes

Hashes for edgefirst_tracker-0.29.4-cp38-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 3ac408dad1cbf0e1997e7c5d5f976b7d4dd33ca682a84a97834a4c14f161d631
MD5 4b6bd3be7600645592b699a16311bda0
BLAKE2b-256 733d03f7ad058ca420d7f6fd8ab034a89102e452ee46c68cf020943832c9112a

See more details on using hashes here.

Provenance

The following attestation bundles were made for edgefirst_tracker-0.29.4-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.29.4-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for edgefirst_tracker-0.29.4-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 e030973098a509592be08064d5fb612a21f4424e2c3ee66328b2f0ac3314a3b2
MD5 9ed92c8064f65229381ca4e7279d376e
BLAKE2b-256 ffe4d692cdf3c4ebfe9a1ba287d9d9aae0720ab8d8325bab2a1726541e5e3b6d

See more details on using hashes here.

Provenance

The following attestation bundles were made for edgefirst_tracker-0.29.4-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.29.4-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for edgefirst_tracker-0.29.4-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 2336f91071c17433458678e90a5ee8ab9fff7a833116fa8526c889b0b81d6ce3
MD5 cdcc90f0e59d9abbb798e4818ecb7cab
BLAKE2b-256 4a90c065e07d19eb3a1847fe46196899a2f80faa7b52776e53ff71bf1764655f

See more details on using hashes here.

Provenance

The following attestation bundles were made for edgefirst_tracker-0.29.4-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.29.4-cp38-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for edgefirst_tracker-0.29.4-cp38-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 52049dc01065b8ec5d14c3a7011189e1eb018378129d9c13879a089c105648e2
MD5 00e47a55b3b5ae91b2c7fabc328cc274
BLAKE2b-256 4aed31d18ed2dbc533036499c85c28994e87a0550caa0a45ed117b6b40c83784

See more details on using hashes here.

Provenance

The following attestation bundles were made for edgefirst_tracker-0.29.4-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

0.30.0

9 files

This release

0.29.4 This release

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