scourtain/reels-engine

릴 설정

ENGINE = node "${CLAUDE_PLUGIN_ROOT}/engine/bin/reels.js" HOME = $REELS_HOME이 설정되어 있으면 그 값을, 그렇지 않으면 Mac의 경우 ~/Movies/Reels, Windows의 경우 ~/Videos/Reels를 사용합니다. ENGINE init-home이 경로를 출력합니다. 명령에서 HOME과 PROJECT 경로는 항상 큰따옴표로 감싸고, 엔진이 출력하는 전체 경로를 그대로 사용하세요(따옴표 안에서 ~는 작동하지 않습니다). Windows에서는 경로에 백슬래시와 공백이 자주 포함되므로 따옴표가 없으면 문제가 발생합니다.

Windows (Claude Code 셸에서 uname -s로 확인: MINGW 또는 MSYS로 시작하면 Windows입니다)에서는 아래 1, 2단계를 건너뛰고 대신 다음을 수행하세요:

• Node 및 ffmpeg: node --version (22 이상)과 ffmpeg -version을 확인합니다. 누락된 항목은 winget install --id OpenJS.NodeJS.LTS -e 및 winget install --id Gyan.FFmpeg -e로 설치합니다. Windows에서 "이 앱이 변경을 수행하도록 허용하시겠습니까?" 창이 나타날 수 있습니다: 사용자가 예를 클릭합니다. 설치 직후에도 도구가 여전히 발견되지 않으면 엔진이 winget 자체 폴더도 확인합니다. ENGINE doctor에서 여전히 빨간색으로 표시되면 사용자에게 Claude를 닫고 다시 열도록 요청한 후 다시 확인하세요.
• Whisper (트랜스크라이버): curl -s https://api.github.com/repos/ggml-org/whisper.cpp/releases/latest로 Windows 다운로드를 찾고 whisper-bin-x64.zip이라는 정확한 이름의 자산을 가져옵니다. 해당 이름의 자산이 없으면 중단하고 사용자에게 "Windows 설정에 최신 Whisper 다운로드를 위한 업데이트가 필요합니다. Sam에게 알렸습니다."라고 말합니다. 그렇지 않으면 mkdir -p "HOME/tools/whisper", curl -L --fail -o "HOME/tools/whisper.zip" <해당 자산의 browser_download_url>, /c/Windows/System32/tar.exe -xf "HOME/tools/whisper.zip" -C "HOME/tools/whisper"를 실행합니다(Windows 자체 tar는 zip 파일을 읽을 수 있지만 Git Bash와 함께 제공되는 tar는 읽을 수 없습니다). 그런 다음 zip 파일을 삭제합니다. whisper-cli.exe가 있는지 확인합니다: ls "HOME/tools/whisper" "HOME/tools/whisper/Release". 두 폴더 중 어디에도 없으면 중단하고 사용자에게 같은 메시지를 전합니다: "Windows 설정에 최신 Whisper 다운로드를 위한 업데이트가 필요합니다. Sam에게 알렸습니다." ENGINE doctor에서 이제 whisper-cli가 초록색으로 표시되어야 합니다.
• 그런 다음 아래 3단계부터 계속합니다. ENGINE doctor에서 선택 사항인 – person cutout 줄은 "현재 Mac 전용"이라고 표시됩니다: 사용자에게 한 번 알려줍니다: "머리 뒤에 타입을 넣는 두 개의 후크 룩은 현재 Mac 전용입니다. 나머지 네 개는 작동합니다." 이에 대한 수정을 제안하지 마십시오.

1. Homebrew (도구 설치 프로그램): which brew를 확인한 다음 /opt/homebrew/bin/brew 및 /usr/local/bin/brew를 확인합니다. 아무것도 없으면 사용자가 일반 Mac 설치 프로그램으로 설치합니다(터미널 필요 없음): https://github.com/Homebrew/brew/releases/latest 로 보내고, .pkg로 끝나는 파일을 다운로드하여 더블클릭하고 클릭하여 진행하도록 합니다(일반 Mac 창에서 Mac 비밀번호를 요청하며, 사용자가 직접 입력하거나 묻지 않습니다). 완료되었다고 말할 때까지 기다린 후 다시 확인합니다. brew가 이름으로 여전히 발견되지 않으면 전체 경로(/opt/homebrew/bin/brew)로 호출하여 다음 단계를 진행합니다.
2. 도구: brew install node ffmpeg whisper-cpp를 실행합니다(이미 있는 것은 건너<0xEC><0x9C><0x84>). 그런 다음 ENGINE doctor를 실행합니다. 빨간색으로 표시된 항목은 fix 힌트를 사용하여 수정합니다.
   • –로 시작하는 줄은 선택 사항입니다. – person cutout은 이 Mac에서 두 개의 후크 카드 룩(머리 뒤 타입)이 꺼져 있음을 의미합니다. 다른 모든 것은 작동합니다. 수정을 한 번 제안합니다: "머리 뒤에 넣는 두 개의 후크 룩을 원하시나요? 터미널에서 xcode-select --install을 실행하고, 설치를 클릭한 다음 '다시 확인'이라고 말씀해 주세요." 설정을 차단하지 마십시오.
3. 렌더러 브라우저 + 음성 모델 (일회성 다운로드, 약 700MB): npx -y [email protected] browser ensure를 실행합니다. 그런 다음 음성 모델이 있는지 확인합니다: ~/.cache/hyperframes/whisper/models/ggml-small.en.bin 또는 HOME/models/ggml-small.en.bin을 확인합니다. 둘 다 없으면 다운로드합니다: mkdir -p "HOME/models" && curl -L --fail -o "HOME/models/ggml-small.en.bin" https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-small.en.bin
4. 작업 공간: ENGINE init-home을 실행합니다. Reels 폴더를 출력하며 기존 파일을 덮어쓰지 않습니다.
5. 기본 정보, 한 번에 하나씩 질문하고 HOME/brand-kit.json에 저장합니다(파일의 다른 모든 키는 유지):
   • Instagram 핸들 → handle
   • 기본 릴 길이(초, 기본값 40) → default_target_seconds
6. 어휘: 자주 말하는 이름, 도구, 브랜드 단어(비즈니스 이름, 제품, 앱)를 물어봅니다. 한 줄에 하나씩 HOME/vocabulary.txt에 작성하여 전사가 올바르게 철자를 적도록 합니다.
7. 스타일. ../reel-style/references/style-interview.md의 스타일 인터뷰를 실행합니다: 캡션 선택 페이지가 열리고 사용자가 선택한 내용이 기본 스타일이 됩니다. 예시 릴이나 링크를 요청하지 마십시오. 인터뷰의 이름 지정 단계는 건너<0xEB><0x9A><0x81>니다. 스타일은 항상 main입니다(HOME/styles/main.json에 바로 저장하며 draft는 사용하지 않습니다). 두 번째 스타일을 제안하지 마십시오. 나중에 /reels-engine:reel-style로 추가할 수 있습니다.
8. 다음으로 마무리합니다: "설정이 완료되었습니다. 1-4개의 클립을 채팅으로 끌어다 놓고 "new reel"이라고 말하세요 (또는 /reels-engine:reel을 입력하세요)."

다시 실행해도 안전합니다: 이미 완료된 단계는 건너<0xEB><0x9A><0x81>니다. 기본 정보는 사용자가 변경을 원할 때만 다시 묻고, 스타일 변경은 /reels-engine:reel-style로 보냅니다.