CV / ByteTrack

ByteTrack

reComputer R Series (CM5 + Hailo-8)

Seguimiento MOT17 de personas con la serie ByteTrack en reComputer R Series con Hailo-8 (S/Tiny/Nano/M) o Hailo-10H (S/Tiny).

20 descargas
Tamaño
14.8 MB
Memoria
4GB+
Precisión
Hailo HEF

Elige el dispositivo que estás usando. La guía de configuración y la documentación se actualizarán en consecuencia.

Primeros pasos

Desplegar
sudo docker run --rm \
  --name pi5-hailo8-bytetrack-s \
  --privileged \
  --net=host \
  -e PYTHONUNBUFFERED=1 \
  --device /dev/hailo0:/dev/hailo0 \
  -v /usr/lib/libhailort.so.4.23.0:/usr/lib/libhailort.so.4.23.0:ro \
  -v /usr/lib/libhailort.so:/usr/lib/libhailort.so:ro \
  ghcr.io/seeed-projects/recomputer-hailo8-cv/bytetrack_s_mot17:latest \
  python web_detection.py --model_path model/bytetrack_s_mot17.hef --video_path video/test.mp4

Detalles del modelo

reComputer R Series (CM5 + Hailo-8)

Seguimiento MOT17 con ByteTrack-S / ByteTrack-Tiny en reComputer R Series (CM5 + Hailo-8)

ByteTrack-S, ByteTrack-Tiny, ByteTrack-Nano y ByteTrack-M siguen personas en vídeo estilo MOT17 en Hailo-8 mediante HailoRT 4.23.x. Los HEF son detectores de personas tipo YOLOX; el host decodifica las nueve cabezas, aplica NMS y la asociación ByteTrack (Kalman + IoU de alta/baja puntuación), y dibuja un track ID estable en la vista previa MJPEG.

Información del modelo

VarianteEntradaHEF incluidoMOTA float / Hailo-8FPS (batch 1)Parámetros / operacionesContenedor
ByteTrack-S608×1088×314.8 MB79.5 / 77.788.38.94M / 43.21Gbytetrack_s_mot17
ByteTrack-Tiny608×1088×39.7 MB77.2 / 76.01265.03M / 24.60Gbytetrack_tiny_mot17
ByteTrack-Nano608×1088×39.8 MB70.1 / 69.063.70.90M / 4.12Gbytetrack_nano_mot17
ByteTrack-M608×1088×381.4 MB86.2 / 86.111.125.28M / 206.12Gbytetrack_m_mot17

Hardware y configuración del host

| Placa | Acelerador | Tiempo de ejecución | Python en el contenedor | |---|---| | Placa | reComputer R Series con Raspberry Pi CM5 | | Acelerador | Hailo-8 por PCIe, expuesto como /dev/hailo0 | | Tiempo de ejecución | HailoRT 4.23.x (host y contenedor deben compartir major.minor) | | Python en el contenedor | 3.11, aarch64 |

bash
sudo apt update
sudo apt install hailo-all -y
sudo reboot

# Tras reiniciar
hailortcli fw-control identify
ls /dev/hailo0

# Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh --mirror Aliyun
sudo systemctl enable docker
sudo systemctl start docker

Ejecutar con vídeo de demostración

Selecciona el comando correspondiente a la variante.

ByteTrack-S

bash
sudo docker run --rm \
  --name pi5-hailo8-bytetrack-s \
  --privileged \
  --net=host \
  -e PYTHONUNBUFFERED=1 \
  --device /dev/hailo0:/dev/hailo0 \
  -v /usr/lib/libhailort.so.4.23.0:/usr/lib/libhailort.so.4.23.0:ro \
  -v /usr/lib/libhailort.so:/usr/lib/libhailort.so:ro \
  ghcr.io/seeed-projects/recomputer-hailo8-cv/bytetrack_s_mot17:latest \
  python web_detection.py --model_path model/bytetrack_s_mot17.hef --video_path video/test.mp4

ByteTrack-Tiny

bash
sudo docker run --rm \
  --name pi5-hailo8-bytetrack-tiny \
  --privileged \
  --net=host \
  -e PYTHONUNBUFFERED=1 \
  --device /dev/hailo0:/dev/hailo0 \
  -v /usr/lib/libhailort.so.4.23.0:/usr/lib/libhailort.so.4.23.0:ro \
  -v /usr/lib/libhailort.so:/usr/lib/libhailort.so:ro \
  ghcr.io/seeed-projects/recomputer-hailo8-cv/bytetrack_tiny_mot17:latest \
  python web_detection.py --model_path model/bytetrack_tiny_mot17.hef --video_path video/test.mp4

Abre http://<Board_IP>:8000 para ver la vista previa con track IDs. El video/test.mp4 incluido es el clip de calle de Hailo.

ByteTrack-Nano

bash
sudo docker run --rm \
  --name pi5-hailo8-bytetrack-nano \
  --privileged \
  --net=host \
  -e PYTHONUNBUFFERED=1 \
  --device /dev/hailo0:/dev/hailo0 \
  -v /usr/lib/libhailort.so.4.23.0:/usr/lib/libhailort.so.4.23.0:ro \
  -v /usr/lib/libhailort.so:/usr/lib/libhailort.so:ro \
  ghcr.io/seeed-projects/recomputer-hailo8-cv/bytetrack_nano_mot17:latest \
  python web_detection.py --model_path model/bytetrack_nano_mot17.hef --video_path video/test.mp4

ByteTrack-M

bash
sudo docker run --rm \
  --name pi5-hailo8-bytetrack-m \
  --privileged \
  --net=host \
  -e PYTHONUNBUFFERED=1 \
  --device /dev/hailo0:/dev/hailo0 \
  -v /usr/lib/libhailort.so.4.23.0:/usr/lib/libhailort.so.4.23.0:ro \
  -v /usr/lib/libhailort.so:/usr/lib/libhailort.so:ro \
  ghcr.io/seeed-projects/recomputer-hailo8-cv/bytetrack_m_mot17:latest \
  python web_detection.py --model_path model/bytetrack_m_mot17.hef --video_path video/test.mp4

Modo cámara USB

bash
sudo docker run --rm \
  --name pi5-hailo8-bytetrack-s \
  --privileged \
  --net=host \
  -e PYTHONUNBUFFERED=1 \
  --device /dev/hailo0:/dev/hailo0 \
  --device /dev/video0:/dev/video0 \
  -v /usr/lib/libhailort.so.4.23.0:/usr/lib/libhailort.so.4.23.0:ro \
  -v /usr/lib/libhailort.so:/usr/lib/libhailort.so:ro \
  ghcr.io/seeed-projects/recomputer-hailo8-cv/bytetrack_s_mot17:latest \
  python web_detection.py --model_path model/bytetrack_s_mot17.hef --camera_id 0

Cambia bytetrack_s_mot17 por bytetrack_tiny_mot17 para ejecutar la variante Tiny.

REST API

EndpointMétodo
ByteTrack-SPOST /api/models/bytetrack_s_mot17/predict
ByteTrack-TinyPOST /api/models/bytetrack_tiny_mot17/predict
ByteTrack-NanoPOST /api/models/bytetrack_nano_mot17/predict
ByteTrack-MPOST /api/models/bytetrack_m_mot17/predict
bash
curl -X POST "http://<Board_IP>:8000/api/models/bytetrack_s_mot17/predict" \
  -F "file=@test.jpg"

Las entradas predictions incluyen track_id, class, confidence y box.

Notas de implementación

  • Los HEF exponen nueve cabezas YOLOX (box/objectness/class) para strides 32/16/8, sin NMS en el chip.
  • El host decodifica center/size, calcula score=obj*class, aplica NMS 0.7 y la asociación ByteTrack.
  • El preprocesamiento hace letterbox a 608×1088 (relleno 114) y BGR→RGB; la normalización ImageNet está en el HEF. Es un modelo solo para personas.

Notas de desarrollo

  • Código: src/rpi5_hailo8_bytetrack{_s,_tiny,_nano,_m}_mot17/
  • Dockerfiles: docker/hailo8/bytetrack{_s,_tiny,_nano,_m}_mot17.dockerfile
  • Contenedores: ghcr.io/seeed-projects/recomputer-hailo8-cv/bytetrack{_s,_tiny,_nano,_m}_mot17:latest
  • HEF: Hailo Model Zoo v2.20.0 (hailo8), sizes and SHA256 in each module's model/README.md

Entradas y salidas

Entrada: imagen, vídeo o fotograma de cámara USB. Salida: cajas person con track ID, confianza y vista previa MJPEG.