Cài đặt VideoMotion
VideoMotion은 ~/.motionfly에 있는 MotionFly와 Python 환경 및 모델을 공유합니다. 이미 MotionFly를 실행 중인 컴퓨터에서는 다시 다운로드할 필요가 없습니다.
모든 플러그인 스킬이 공통으로 사용하는 변수(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
모든 Python(3.10 이상) 시스템에서 실행:
python "$VV/tools/setup/doctor.py"
결과 표를 읽습니다. 필수 그룹(Node.js 22+, ffmpeg, ffprobe, ffmpeg loudnorm, HyperFrames)에 THIẾU 행이 있으면 사용자에게 직접 설치하도록 안내하고, 비고 열에 있는 링크를 함께 제공합니다. 시스템 소프트웨어를 직접 설치하지 마십시오.
Bước 2. Cài phần Python và model
"Môi trường Python" 또는 "Giọng VieNeu"가 누락된 경우 사용자에게 확인 메시지를 한 번 표시합니다(약 2~3GB 다운로드: Python 패키지, VieNeu 모델, Whisper large-v3-turbo 모델). 그런 다음 백그라운드에서 실행:
python "$VV/tools/setup/doctor.py" --install > "$HOME/.motionfly/install.log" 2>&1
이 명령어는 ~/.motionfly/venv에 가상 환경을 생성하고(uv가 있으면 사용), vieneu, faster-whisper, soundfile, numpy, scipy를 설치한 후 모델을 다운로드합니다. 또한, Hugging Face 캐시의 심볼릭 링크 오류(ONNX Runtime에서 "External data path escapes model directory" 오류 발생)를 자동으로 수정합니다.
Bước 3. Skill HyperFrames cho Claude
"Skill HyperFrames cho Claude" 행이 tùy chọn(미설치)인 경우, 사용자에게 npx [email protected] skills를 실행하도록 제안합니다. 이 스킬이 있으면 프레임 구성 작성이 더 표준화되지만, 없더라도 agents/vm-canh.md의 기술 계약 덕분에 정상 작동합니다.
Kết thúc
1단계를 다시 실행합니다. SAN SANG이 표시되면 사용자에게 /videomotion 명령어와 함께 비디오 요청을 입력하도록 안내합니다.
참고: NVIDIA 카드가 없는 컴퓨터의 경우, VieNeu 음성은 CPU에서 실행되며(중급 컴퓨터에서 음성 1초당 약 0.4초 소요), 배경 음악은 사용자가 제공한 파일 또는 코드로 합성한 음악을 사용합니다.