Cài đặt VideoMotion
VideoMotion dùng chung môi trường Python và model với MotionFly ở ~/.motionfly: máy đã chạy MotionFly thì không phải tải lại gì.
Biến dùng chung cho mọi skill của plugin (chạy trong Bash):
VV="${CLAUDE_PLUGIN_ROOT}"
PY="$HOME/.motionfly/venv/Scripts/python.exe"; [ -x "$PY" ] || PY="$HOME/.motionfly/venv/bin/python"
export PYTHONUTF8=1 HF_HUB_DISABLE_PROGRESS_BARS=1
Bước 1. Kiểm tra
Chạy bằng Python hệ thống bất kỳ (3.10 trở lên):
python "$VV/tools/setup/doctor.py"
Đọc bảng kết quả. Dòng THIẾU ở nhóm bắt buộc (Node.js 22+, ffmpeg, ffprobe, ffmpeg loudnorm, HyperFrames) thì báo người dùng tự cài, kèm link trong cột ghi chú. Không tự cài phần mềm hệ thống.
Bước 2. Cài phần Python và model
Nếu thiếu "Môi trường Python" hoặc "Giọng VieNeu", hỏi người dùng một câu xác nhận (sẽ tải khoảng 2 đến 3 GB: gói Python, model VieNeu, model Whisper large-v3-turbo), rồi chạy nền:
python "$VV/tools/setup/doctor.py" --install > "$HOME/.motionfly/install.log" 2>&1
Lệnh này tạo venv ở ~/.motionfly/venv (dùng uv nếu có), cài vieneu, faster-whisper, soundfile, numpy, scipy, tải model, và tự sửa lỗi symlink của bộ đệm Hugging Face (ONNX Runtime báo "External data path escapes model directory").
Bước 3. Skill HyperFrames cho Claude
Nếu dòng "Skill HyperFrames cho Claude" là tùy chọn (chưa cài), đề nghị người dùng chạy npx [email protected] skills. Có bộ skill này thì bước dựng hình viết composition chuẩn hơn; không có vẫn chạy được nhờ hợp đồng kỹ thuật trong agents/vm-canh.md.
Kết thúc
Chạy lại Bước 1. Thấy SAN SANG thì báo người dùng gõ /videomotion kèm yêu cầu video.
Ghi chú máy không có card NVIDIA: giọng VieNeu chạy CPU (khoảng 0,4 giây cho mỗi giây giọng trên máy tầm trung), nhạc nền dùng file người dùng đưa hoặc nhạc tổng hợp bằng code.