CV / CenterPose

CenterPose RegNetX-800MF

CenterPose uses a RegNetX-800MF backbone to estimate person boxes and 17 body keypoints in one pass on Hailo-8.

4 次下载

大小

13.93 MB

内存

4GB+

精度

Hailo HEF / HailoRT 4.23.x

选择你正在使用的设备，设置指南和文档将相应更新。

平台

推理引擎

快速开始

部署

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

REST API

使用 REST API 进行推理。复制以下命令。

Curl

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

Python

import requests

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

模型详情

CenterPose RegNetX-800MF on reComputer R Series (CM5 + Hailo-8)

CenterPose RegNetX-800MF performs bottom-up, multi-person pose estimation in a single network pass. The Hailo-8 demo returns person boxes and 17 COCO body keypoints, and provides live MJPEG preview, image inference, and offline video analysis through a FastAPI service.

Model information

Property	Value
Architecture	CenterPose with RegNetX-800MF backbone
Task	Multi-person pose estimation
Input	512×512×3 BGR
Output	Person boxes and 17 COCO keypoints
Parameters	12.31M
HEF source	Hailo Model Zoo v2.19.0, compiled for Hailo-8
Runtime	HailoRT 4.23.x

Hardware and host setup

Item	Value
Board	reComputer R Series with Raspberry Pi CM5
Accelerator	Hailo-8 over PCIe, exposed as `/dev/hailo0`
OS	Raspberry Pi OS, aarch64
Validated runtime	HailoRT 4.23.x

bash

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

# Verify after reboot
hailortcli --version
hailortcli fw-control identify
ls -l /dev/hailo0

The driver, device firmware, host libhailort.so, and Python wheel in the container must share the same HailoRT major/minor version.

Run with the bundled demo video

The video is reused from the yolov8_pose application as requested.

bash

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

Open http://<R20_IP>:8000 to view the annotated stream and video-analysis UI.

USB camera mode

bash

sudo docker run --rm --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/centerpose_regnetx_800mf:latest \
  python web_detection.py \
    --model_path model/centerpose_regnetx_800mf.hef \
    --camera_id 0

REST API

text

POST http://<R20_IP>:8000/api/models/centerpose_regnetx_800mf/predict

bash

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

Endpoint	Method	Purpose
`/`	GET	Web preview UI
`/api/models/centerpose_regnetx_800mf/predict`	POST	Single-frame pose inference
`/api/video_feed`	GET	Annotated MJPEG stream
`/api/config`	GET / POST	Read or change confidence/NMS thresholds
`/api/video/upload`	POST	Upload a source video
`/api/video/analyze`	POST	Start offline video analysis
`/api/video/status`	GET	Read analysis progress
`/api/video/download/{filename}`	GET	Download the annotated result

Implementation details

Source: src/rpi5_hailo8_centerpose_regnetx_800mf/
Dockerfile: docker/hailo8/centerpose_regnetx_800mf.dockerfile
HEF: model/centerpose_regnetx_800mf.hef (14,609,405 bytes)
The decoder handles CenterPose heads hm, wh, hps, reg, hm_hp, and hp_offset, then maps detections back through the input letterbox transform.
CenterPose uses the original OpenCV BGR order because normalization is built into this HEF.

输入与输出

输入：图像、视频或 USB 摄像头帧。输出：人物边界框、置信度、17 个 COCO 关键点及带标注的 MJPEG 预览。