notasimrazzaq/AI-Video-Editor

Verifica ou repara o conjunto de ferramentas de edição de vídeo neste PC Windows (Node 22+, FFmpeg, chave Deepgram, Chrome, skills HyperFrames). Use quando: a transcrição ou renderização falhar, um novo PC precisar de configuração, o arquivo .setup-ok estiver ausente, ou o usuário pedir para atualizar o HyperFrames.

O que é AI-Video-Editor?

Este skill verifica e repara automaticamente o ambiente de edição de vídeo em PCs Windows, garantindo que Node.js 22+, FFmpeg, Chrome, a chave da API Deepgram e os skills HyperFrames estejam instalados e funcionando corretamente. Ele foi projetado para ser executado em modo não assistido, é seguro reexecutar e escreve um arquivo de flag `.setup-ok` ao concluir com sucesso. Caso algo não possa ser corrigido automaticamente, o script exibe uma mensagem clara de falha e a solução necessária. É útil quando a transcrição ou renderização falha, um novo computador precisa ser configurado, ou o usuário solicita a atualização dos componentes do HyperFrames. O skill usa PowerShell para executar scripts, evita modelos locais de transcrição (whisper.cpp) por serem lentos e ruidosos, e inclui comandos como `hyperframes doctor` para diagnósticos rápidos e `tools/set-deepgram-key.ps1` para configurar a chave Deepgram com segurança.

Funciona com✓Claude Code~Codex CLI~Cursor

npx skills add https://github.com/notasimrazzaq/AI-Video-Editor/tree/HEAD/.agents/skills/mg-setup-check

Documentação

Verificação de configuração (Windows)

Instale ou repare tudo (não assistido, seguro reexecutar, escreve .setup-ok ao finalizar com sucesso):

powershell -NoProfile -ExecutionPolicy Bypass -File tools/setup.ps1

Ele exibe SETUP FAILED: <motivo> com a correção quando algo não pode ser feito automaticamente.

Configuração conhecida como correta:

Ferramenta	Onde
Node.js 22+	winget `OpenJS.NodeJS.LTS` → `C:\Program Files\nodejs`
FFmpeg / FFprobe	winget `Gyan.FFmpeg`
Transcrição / Voz IA	API Deepgram via `tools/transcribe-deepgram.ps1`, chave na variável de ambiente do usuário `DEEPGRAM_API_KEY`
Chrome	instalação do sistema, ou uma cópia privada de `npx --yes hyperframes browser ensure`
Skills HyperFrames	`%USERPROFILE%\.agents\skills` (+ `.claude\skills`)

Não instale whisper.cpp nem execute modelos de transcrição locais (lentos e barulhentos em PCs típicos).

Verificação

npx -y hyperframes doctor

Docker, Kokoro (TTS), MusicGen e whisper-cpp não são necessários aqui — ignore-os.

Correções comuns

Chave Deepgram: o usuário executa powershell -NoProfile -ExecutionPolicy Bypass -File tools/set-deepgram-key.ps1 por conta própria (nunca cole no chat). Os scripts leem o valor do escopo do usuário mesmo em terminais antigos.
node / ffmpeg não encontrados logo após a configuração: atualize o PATH no terminal ($env:Path = [Environment]::GetEnvironmentVariable('Path','Machine') + ';' + [Environment]::GetEnvironmentVariable('Path','User')) ou reinicie o editor.
"execução de scripts está desabilitada": sempre chame scripts via powershell -NoProfile -ExecutionPolicy Bypass -File ....
Deepgram 401: chave errada/expirada — peça ao usuário para defini-la novamente. 402/429: sem crédito / limite de taxa excedido.
Atualizar skills / CLI: npx -y hyperframes skills update, npx -y hyperframes upgrade.
Qualquer coisa que precise de direitos de administrador: forneça ao usuário o comando exato para executar em um terminal administrativo.