reComputer R + Hailo-8 上の人流属性分析 Web アプリ

Hailo-8 / Person Attribute をベースにした、エッジの人流属性分析システム。

本プロジェクトのソースコードは GitHub で確認できます: https://github.com/doublelf/People_Aattribute_flow

reComputer R 上で YOLOv8n 人物検出 + Person Attribute ResNet 属性認識によるオフライン動画分析を行い、ブラウザ上でリアルタイム再生と統計を表示します。性別および 4 段階の年齢区分によるリアルタイムカウントと累積分析をサポートします。

クイックスタート

1. コードをクローン

bash

git clone https://github.com/doublelf/People_Aattribute_flow.git
cd People_Aattribute_flow

2. ローカルデバッグ用

bash

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

3. イメージのビルド

bash

docker build -t perview:latest .

4. ワンクリック起動

bash

sudo docker run --rm --privileged --net=host \
  -e VIDEO_PATH=/app/video/a1-1.mp4 \
  --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 \
  -v /home/seeed/perview/app:/app/app:ro \
  -v /home/seeed/perview/detection:/app/detection:ro \
  -v /home/seeed/perview/workspace:/app/workspace \
  -v /home/seeed/perview/video/:/app/video:ro \
  perview:latest

パラメータを行ごとに説明:

行	役割
`--rm --privileged`	コンテナ終了時に自動クリーンアップされ、すべてのデバイス権限を取得(Hailo PCIe 必須)
`--net=host`	ホストネットワークを直接使用し、`-p` ポートマッピング不要でアクセスを簡略化
`-e VIDEO_PATH=/app/video/a1-1.mp4`	デフォルトの入力動画パス(コンテナ視点)
`--device /dev/hailo0:/dev/hailo0`	Hailo-8 デバイスをコンテナへ透過
`-v /usr/lib/libhailort.so.4.23.0:/usr/lib/libhailort.so.4.23.0:ro`	ホストの HailoRT ランタイムライブラリをコンテナにマウント(読み取り専用)
`-v /usr/lib/libhailort.so:/usr/lib/libhailort.so:ro`	同上、シンボリックリンク互換
`-v /home/seeed/perview/app:/app/app:ro`	ローカルソースコードがイメージ内のコードを上書き、Python ファイル変更後はコンテナ再起動だけで反映(読み取り専用、コンテナがホストへ誤って書き込むのを防止)
`-v /home/seeed/perview/detection:/app/detection:ro`	同上、検出モジュールを上書き
`-v /home/seeed/perview/workspace:/app/workspace`	プリレンダ成果物とアップロードファイルを永続化(読み書き)
`-v /home/seeed/perview/video/:/app/video:ro`	動画保存ディレクトリをコンテナにマウント(読み取り専用)

コンテナ起動後、自動的に a1-1.mp4 のプリレンダリングが始まります(約 1 分、1080p では処理速度約 4–6 fps、シーン密度による)。

5. Web UI にアクセス

ブラウザで開きます:

http://<board_ip>:8000/

スタートページの読み込み後、左側がアノテーション付き動画プレーヤ、右側が Chart.js のリアルタイムダッシュボード(現在の人数、男女比、4 段階年齢分布、累積統計)です。

デフォルト動画 /home/seeed/perview/video/a1-1.mp4 はリポジトリに同梱されています。任意のカスタム動画を置いたら -e VIDEO_PATH を適宜変更してください。