Files
managed-portal/managed/people_flow_project/docs/plans/2026-04-08-deepface-portable-weights.md
2026-04-27 10:04:36 +08:00

2.1 KiB

Portable DeepFace Weights Implementation Plan

For Claude: REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.

Goal: Make the native RTSP bundle reuse bundled DeepFace weights from any unpack location without extra downloads.

Architecture: Remove the custom DEEPFACE_HOME override from the native runtime path. Before setup and launch, copy the bundled DeepFace weight files from weights/deepface/ into the current user's default ~/.deepface/weights/ directory so DeepFace resolves them through its own standard path logic.

Tech Stack: Bash, DeepFace, native Python virtual environment, offline wheelhouse bundle


Task 1: Fix native setup and launcher paths

Files:

  • Modify: run_rtsp.sh
  • Modify: setup_native_venv.sh
  • Modify: README_NATIVE.md

Step 1: Update run_rtsp.sh

Remove the DEEPFACE_HOME override. Create "$HOME/.deepface/weights" and copy bundled .h5 files from "$PROJECT_ROOT/weights/deepface" into that directory before starting the Python process.

Step 2: Update setup_native_venv.sh

After dependency installation, create "$HOME/.deepface/weights" and copy bundled .h5 files into it so the environment is ready before the first run.

Step 3: Update native documentation

Explain that bundled weights are staged into ~/.deepface/weights automatically and that the project path itself can move without breaking the weight lookup.

Task 2: Sync and verify on the Ubuntu target

Files:

  • Modify: remote copies of the files above under /home/x/people/people_flow_project

Step 1: Sync the changed files to 192.168.5.154

Copy the updated launcher, setup script, and documentation.

Step 2: Stage bundled weights into the target user's home directory

Run the updated setup logic or equivalent copy command and verify ~/.deepface/weights contains the expected .h5 files.

Step 3: Restart RTSP and inspect logs

Restart the RTSP job and confirm the log no longer shows downloads from deepface_models/releases.

Step 4: Commit

Skip commit unless explicitly requested by the user.