scourtain/reels-engine

Configuração do Reel

ENGINE = node "${CLAUDE_PLUGIN_ROOT}/engine/bin/reels.js" HOME = $REELS_HOME se definido, caso contrário ~/Movies/Reels no Mac e ~/Videos/Reels no Windows. ENGINE init-home exibe o caminho. Em comandos, sempre coloque os caminhos HOME e PROJECT entre aspas duplas, escritos por extenso conforme o mecanismo os imprime (um ~ dentro de aspas não funciona). No Windows eles têm barras invertidas e frequentemente espaços, o que quebra sem as aspas.

No Windows (verifique com uname -s: começa com MINGW ou MSYS no shell do Claude Code no Windows), pule as etapas 1 e 2 abaixo e faça o seguinte:

• Node e ffmpeg: verifique node --version (22 ou mais recente) e ffmpeg -version. Instale o que estiver faltando com winget install --id OpenJS.NodeJS.LTS -e e winget install --id Gyan.FFmpeg -e. O Windows pode mostrar uma janela "Deseja permitir que este aplicativo faça alterações": o membro clica em Sim. Se uma ferramenta ainda não for encontrada logo após a instalação, o mecanismo também procura na própria pasta do winget; se ENGINE doctor ainda mostrar vermelho, peça ao membro para fechar e reabrir o Claude e verifique novamente.
• Whisper (o transcritor): encontre o download do Windows com curl -s https://api.github.com/repos/ggml-org/whisper.cpp/releases/latest e pegue o asset nomeado exatamente whisper-bin-x64.zip. Se nenhum asset tiver esse nome, pare e informe ao membro: "A configuração do Windows precisa de uma atualização para o download mais recente do Whisper. Sam foi informado." Caso contrário, mkdir -p "HOME/tools/whisper", curl -L --fail -o "HOME/tools/whisper.zip" <o browser_download_url desse asset>, /c/Windows/System32/tar.exe -xf "HOME/tools/whisper.zip" -C "HOME/tools/whisper" (o tar nativo do Windows lê arquivos zip; o tar que vem com o Git Bash não), então delete o zip. Verifique se whisper-cli.exe foi colocado: ls "HOME/tools/whisper" "HOME/tools/whisper/Release". Se não estiver em nenhuma das pastas, pare e informe ao membro a mesma mensagem: "A configuração do Windows precisa de uma atualização para o download mais recente do Whisper. Sam foi informado." ENGINE doctor agora deve mostrar whisper-cli verde.
• Em seguida, continue a partir da etapa 3 abaixo. Em ENGINE doctor, a linha opcional – person cutout diz "apenas no Mac por enquanto": informe ao membro uma vez: "Os dois looks de gancho que colocam o tipo atrás da sua cabeça são apenas para Mac por enquanto. Os outros quatro funcionam." Não ofereça nenhuma correção para isso.

1. Homebrew (o instalador de ferramentas): verifique which brew, depois /opt/homebrew/bin/brew e /usr/local/bin/brew. Se nenhum existir, o membro instala com um instalador Mac normal, sem Terminal: envie para https://github.com/Homebrew/brew/releases/latest, peça para baixar o arquivo que termina em .pkg, clicar duas vezes e seguir os passos (solicita a senha do Mac em uma janela normal do Mac; você nunca digita ou pergunta por ela). Aguarde até que ele diga que está pronto, depois verifique novamente. Se brew ainda não for encontrado pelo nome, use o caminho completo (/opt/homebrew/bin/brew) para a próxima etapa.
2. Ferramentas: brew install node ffmpeg whisper-cpp (pule o que já existe). Depois ENGINE doctor. Corrija qualquer coisa vermelha usando a dica fix.
   • Uma linha começando com – é opcional. – person cutout significa que dois looks de cartão de gancho (tipo atrás da sua cabeça) estão desativados neste Mac; todo o resto funciona. Ofereça a correção uma vez: "Quer os dois looks de gancho atrás da cabeça? Execute xcode-select --install no Terminal, clique em Instalar e depois diga 'verificar novamente'." Não bloqueie a configuração nisso.
3. Navegador renderizador + modelo de fala (downloads únicos, cerca de 700MB): execute npx -y [email protected] browser ensure. Depois verifique se o modelo de fala está presente: verifique ~/.cache/hyperframes/whisper/models/ggml-small.en.bin ou HOME/models/ggml-small.en.bin. Se nenhum existir, baixe-o: 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. Espaço de trabalho: ENGINE init-home. Ele exibe a pasta Reels e nunca sobrescreve arquivos existentes.
5. O básico, uma pergunta de cada vez, salvo em HOME/brand-kit.json (mantenha todas as outras chaves que já estiverem no arquivo):
   • Handle do Instagram → handle
   • Duração padrão do reel em segundos (padrão 40) → default_target_seconds
6. Vocabulário: pergunte por nomes, ferramentas e palavras de marca que eles dizem com frequência (nome do negócio, produtos, aplicativos). Escreva-os um por linha em HOME/vocabulary.txt para que a transcrição os escreva corretamente.
7. O estilo deles. Execute a entrevista de estilo em ../reel-style/references/style-interview.md: ela abre a página de seleção de legendas, e o que eles escolherem lá se torna o estilo padrão. Não peça um exemplo de reel ou um link. Pule a etapa de nomeação da entrevista: o estilo é sempre main (escreva diretamente em HOME/styles/main.json, sem draft). Não ofereça um segundo estilo; eles podem adicionar um depois com /reels-engine:reel-style.
8. Finalize com: "Você está configurado. Arraste 1-4 clipes para o chat e diga "novo reel" (ou digite /reels-engine:reel)."

Reexecutar é seguro: pule o que já foi feito. Pergunte o básico novamente apenas se eles quiserem alterar, e envie alterações de estilo para /reels-engine:reel-style.