scourtain/reels-engine

Configuración de Reels

ENGINE = node "${CLAUDE_PLUGIN_ROOT}/engine/bin/reels.js" HOME = $REELS_HOME si está definido, de lo contrario ~/Movies/Reels en Mac y ~/Videos/Reels en Windows. ENGINE init-home lo imprime. En los comandos, siempre ponga las rutas HOME y PROJECT entre comillas dobles, escritas completas como las imprime el motor (una ~ dentro de las comillas no funciona). En Windows tienen barras invertidas y a menudo espacios, lo que falla sin las comillas.

En Windows (verifique con uname -s: comienza con MINGW o MSYS en el shell de Claude Code en Windows), omita los pasos 1 y 2 a continuación y en su lugar haga esto:

• Node y ffmpeg: verifique node --version (22 o más reciente) y ffmpeg -version. Instale lo que falte con winget install --id OpenJS.NodeJS.LTS -e y winget install --id Gyan.FFmpeg -e. Windows puede mostrar una ventana "¿Quieres permitir que esta aplicación realice cambios?": el miembro hace clic en Sí. Si una herramienta aún no se encuentra justo después de instalarla, el motor también busca en la propia carpeta de winget; si ENGINE doctor aún la muestra en rojo, pídale al miembro que cierre y vuelva a abrir Claude, luego verifique de nuevo.
• Whisper (el transcriptor): busque la descarga para Windows con curl -s https://api.github.com/repos/ggml-org/whisper.cpp/releases/latest y tome el asset nombrado exactamente whisper-bin-x64.zip. Si ningún asset tiene ese nombre, deténgase y dígale al miembro: "La configuración de Windows necesita una actualización para la descarga más reciente de Whisper. Se le ha informado a Sam." De lo contrario mkdir -p "HOME/tools/whisper", curl -L --fail -o "HOME/tools/whisper.zip" <la browser_download_url de ese asset>, /c/Windows/System32/tar.exe -xf "HOME/tools/whisper.zip" -C "HOME/tools/whisper" (el tar de Windows lee archivos zip; el tar que viene con Git Bash no), luego elimine el zip. Verifique que whisper-cli.exe haya llegado: ls "HOME/tools/whisper" "HOME/tools/whisper/Release". Si no está en ninguna de las dos carpetas, deténgase y dígale al miembro el mismo mensaje: "La configuración de Windows necesita una actualización para la descarga más reciente de Whisper. Se le ha informado a Sam." ENGINE doctor ahora debería mostrar whisper-cli en verde.
• Luego continúe desde el paso 3 a continuación. En ENGINE doctor, la línea opcional – person cutout dice "solo en Mac por ahora": dígale al miembro una vez, "Los dos looks de gancho que ponen el tipo detrás de tu cabeza son solo para Mac por ahora. Los otros cuatro funcionan." No ofrezca ninguna solución para ello.

1. Homebrew (el instalador de herramientas): verifique which brew, luego /opt/homebrew/bin/brew y /usr/local/bin/brew. Si ninguno existe, el miembro lo instala con un instalador normal de Mac, sin Terminal: envíelo a https://github.com/Homebrew/brew/releases/latest, pídale que descargue el archivo que termina en .pkg, que haga doble clic y que siga los pasos (solicita su contraseña de Mac en la ventana habitual de Mac; usted nunca la escribe ni la pregunta). Espere a que diga que terminó, luego verifique de nuevo. Si brew aún no se encuentra por nombre, llámelo por su ruta completa (/opt/homebrew/bin/brew) para el siguiente paso.
2. Herramientas: brew install node ffmpeg whisper-cpp (omita lo que ya esté instalado). Luego ENGINE doctor. Corrija cualquier cosa en rojo usando su sugerencia fix.
   • Una línea que comience con – es opcional. – person cutout significa que dos looks de gancho (tipo detrás de tu cabeza) están desactivados en este Mac; todo lo demás funciona. Ofrezca la solución una vez: "¿Quieres los dos looks de gancho detrás de la cabeza? Ejecuta xcode-select --install en Terminal, haz clic en Instalar, luego di 'revisa de nuevo'." No bloquee la configuración por esto.
3. Navegador de renderizado + modelo de voz (descargas únicas, aproximadamente 700 MB): ejecute npx -y [email protected] browser ensure. Luego asegúrese de que el modelo de voz esté presente: verifique ~/.cache/hyperframes/whisper/models/ggml-small.en.bin o HOME/models/ggml-small.en.bin. Si ninguno existe, descárguelo: 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. Espacio de trabajo: ENGINE init-home. Imprime la carpeta de Reels y nunca sobrescribe archivos existentes.
5. Lo básico, una pregunta a la vez, guardado en HOME/brand-kit.json (mantenga cualquier otra clave que ya esté en el archivo):
   • Usuario de Instagram → handle
   • Duración predeterminada del reel en segundos (predeterminado 40) → default_target_seconds
6. Vocabulario: pregunte por nombres, herramientas y palabras de marca que dicen a menudo (su nombre comercial, productos, aplicaciones). Escríbalos uno por línea en HOME/vocabulary.txt para que la transcripción los escriba correctamente.
7. Su estilo. Ejecute la entrevista de estilo en ../reel-style/references/style-interview.md: abre la página de selección de subtítulos, y lo que elijan allí se convierte en su estilo predeterminado. No pida un reel de ejemplo ni un enlace. Omita el paso de nombramiento de la entrevista: el estilo siempre es main (escríbalo directamente en HOME/styles/main.json, sin draft). No ofrezca un segundo estilo; pueden agregar uno más tarde con /reels-engine:reel-style.
8. Termine con: "Estás listo. Arrastra 1-4 clips al chat y di 'nuevo reel' (o escribe /reels-engine:reel)."

Volver a ejecutarlo es seguro: omita lo que ya está hecho. Solo pregunte lo básico nuevamente si quieren cambiarlo, y envíe los cambios de estilo a /reels-engine:reel-style.