blender-mask-peoples/README.md

Blender Plugin: Mask Peoples

街歩き映像に対して自動モザイクを掛けるために開発しました。

使用：https://github.com/akanametov/yolo-face

開発者向け情報

GPU環境の確認

推論サーバーは起動時に環境診断情報を出力します：

• Python環境（バージョン、仮想環境の検出）
• ROCm環境変数（ROCM_PATH、HSA_OVERRIDE_GFX_VERSION等）
• GPU検出状況（デバイス名、ROCmバージョン）

# サーバーを起動して診断ログを確認
python server/main.py

# サーバーのGPU状態を確認
python test_server_api.py --status

出力例：

[FaceMask Server] Startup Diagnostics
======================================================================
[Python Environment]
  Python Version: 3.12.12
  Virtual Environment: Yes

[ROCm Environment Variables]
  ROCM_PATH: /nix/store/.../clr-7.1.1
  HSA_OVERRIDE_GFX_VERSION: 11.0.0

[GPU Detection]
  torch.cuda.is_available(): True
  GPU Device 0: AMD Radeon Graphics
  ROCm Version (HIP): 7.0.51831
======================================================================

処理プロセスの単体デバッグ

顔検出処理をBlenderから独立してテストできます。

# 画像ファイルでテスト
python debug_detector.py --image test.jpg

# 動画ファイルでテスト
python debug_detector.py --video test.mp4 --frame 0

# クイックテスト（簡易版）
./test_quick.sh test.jpg

詳細は docs/debugging.md を参照してください。