CV / LightFace

LightFace Slim

Ultralichte gezichtsdetectie (0,26M parameters) op reComputer R Series met Hailo-8 of Hailo-10H.

64 downloads

Geheugen

4GB+

Precisie

Hailo HEF

Kies het apparaat dat je gebruikt. De installatiehandleiding en documentatie worden dienovereenkomstig bijgewerkt.

Platform

Inferentie-engine

Aan de slag

Implementeren

sudo docker run --rm \
  --name cm5-hailo8-lightface \
  --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/lightface_slim:latest \
  python web_detection.py --model_path model/lightface_slim.hef --video_path video/test.mp4

REST API

Gebruik de REST API om inferentie uit te voeren. Kopieer de onderstaande commando's.

Curl

curl -X POST "http://<Board_IP>:8000/api/models/lightface_slim/predict" \
  -F "file=@test.jpg"

Python

import requests

resp = requests.post(
    "http://<Board_IP>:8000/api/models/lightface_slim/predict",
    files={"file": open("test.jpg", "rb")},
    timeout=30,
)
print(resp.json())

Modeldetails

reComputer R Series (CM5 + Hailo-8)

LightFace Slim op reComputer R Series (CM5 + Hailo-8)

Ultraleichte gezichtsdetectie (0.26M parameters) op Hailo-8 via HailoRT 4.23. De HEF levert ruwe SSD-heads (geen on-chip NMS): de host bouwt de 4,420 ankers op, voert de SSD-boxdecodering (varianties 10/5), de softmax over de achtergrond-/gezichtslogits, de score-afkap en greedy NMS uit.

Deze pagina is gericht op reComputer R Series (CM5 + Hailo-8) met een PCIe Hailo-8-accelerator.

Modelinformatie

Eigenschap	Waarde
Architectuur	Ultra-Light-Fast-Generic-Face-Detector-1MB (SSD-stijl, strides 8/16/32/64)
Taak	Gezichtsdetectie (enkele "face"-klasse, WIDER FACE)
Invoer	240×320×3 (de app levert uint8 BGR; gemiddelde 127 / std 128 zitten in de HEF ingebakken)
Uitvoer	8 ruwe heads: 4 schalen × {bbox-deltas, achtergrond- + gezichtslogits}
Decodering	SSD-decodering op de host (varianties 10/5) + softmax + greedy NMS (`meta_arch=retinaface`)
Parameters	0.26M
Bewerkingen	0.16G
Referentie-mAP	39.71 (WIDER FACE, volledige precisie, Hailo Model Zoo; niet op dit board gemeten)
Licentie	MIT (Ultra-Light-Fast-Generic-Face-Detector-1MB)
Bron	Hailo Model Zoo

Hardware en hostinstellingen

Onderdeel	Waarde
Board	reComputer R Series met Raspberry Pi CM5
Accelerator	Hailo-8 via PCIe, beschikbaar als `/dev/hailo0`
Runtime	HailoRT 4.23.x (host / container moeten dezelfde major.minor delen)
Python in container	3.11, aarch64

bash

sudo apt update
sudo apt install hailort hailort-pcie-driver python3-hailort
sudo reboot

# After reboot
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

Installeer hailort hailort-pcie-driver python3-hailort rechtstreeks — niet hailo-all, dat de Hailo-10H-/HailoRT 5.x-pakketten kan meenemen.

Uitvoeren met de demo-video

bash

sudo docker run --rm --privileged --net=host \
  --name cm5-hailo8-lightface \
  -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/lightface_slim:latest \
  python web_detection.py --model_path model/lightface_slim.hef --video_path video/test.mp4

USB-cameramodus

bash

sudo docker run --rm --privileged --net=host \
  --name cm5-hailo8-lightface \
  -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/lightface_slim:latest \
  python web_detection.py --model_path model/lightface_slim.hef --camera_id 0

Open http://<Board_IP>:8000 om de webpreview te bekijken.

HEF-bestanden

HEF	Grootte	Opmerkingen
`lightface_slim.hef`	1,907,332 bytes	Hailo-8-build van Hailo Model Zoo v2.19.0; 8 ruwe heads

Bron:

text

https://hailo-model-zoo.s3.eu-west-2.amazonaws.com/ModelZoo/Compiled/v2.19.0/hailo8/lightface_slim.hef

SHA256: e448c0f692f9e907bb7328fc2305ced4d3569f1e0aa26d44439d1a6f003e9314

REST API

text

POST http://<Board_IP>:8000/api/models/lightface_slim/predict

bash

curl -X POST "http://<Board_IP>:8000/api/models/lightface_slim/predict" \
  -F "file=@test.jpg"

Respons (box is [x1, y1, x2, y2] in pixels van het originele frame):

json

{
  "predictions": [
    {"box": [220, 156, 260, 196], "confidence": 0.98}
  ]
}

Endpoint	Methode	Doel
`/`	GET	Webvoorbeeld-UI
`/api/models/lightface_slim/predict`	POST	Gezichtsboxen (JSON)
`/api/video_feed`	GET	MJPEG-voorbeeldstream
`/api/config`	GET / POST	Confidence-/IoU-drempels

Implementatienotities

Ankerset uit de configuratie van het Model Zoo: steps 8/16/32/64, min_sizes [10,16,24] / [32,48] / [64,96] / [128,192,256] → 4,420 ankers.
Confidence-drempel van de preview 0.5; de evaluatie van het Model Zoo gebruikt 0.1 met NMS-IoU 0.3.
Het frame wordt geschaald met behoud van de beeldverhouding en onderaan/rechts opgevuld met 0, overeenkomstig de voorbewerking voor gezichtsdetectie van het Model Zoo.

Ontwikkeling

Bron: src/rpi5_hailo8_lightface_slim/
Dockerfile: docker/hailo8/lightface_slim.dockerfile
Validatielog: src/rpi5_hailo8_lightface_slim/TEST_REPORT.md

Invoer en uitvoer

Input: image (240x320 RGB). Output: face bounding boxes with confidence scores.