notasimrazzaq/AI-Video-Editor

Vérifie ou répare la chaîne d'outils de montage vidéo sur ce PC Windows (Node 22+, FFmpeg, clé Deepgram, Chrome, compétences HyperFrames). À utiliser lorsque la transcription ou le rendu échoue, qu'un nouveau PC nécessite une configuration, que .setup-ok est manquant, ou que l'utilisateur demande de mettre à jour HyperFrames.

Qu'est-ce que AI-Video-Editor ?

Cette compétence permet de s'assurer que l'environnement de montage vidéo assisté par IA est correctement installé et fonctionnel sur un PC Windows. Elle exécute un script PowerShell (tools/setup.ps1) qui installe silencieusement Node.js 22+, FFmpeg/FFprobe, et s'assure que les dépendances HyperFrames sont en place, en écrivant un fichier `.setup-ok` en cas de succès. Elle intègre également une commande `hyperframes doctor` pour diagnostiquer les problèmes courants (clé Deepgram invalide, PATH non mis à jour, scripts bloqués par la politique d'exécution). L'outil est conçu pour être relancé sans danger et fournit des messages d'erreur explicites avec les correctifs à appliquer. Il évite délibérément d'installer whisper.cpp ou d'autres modèles de transcription locaux, souvent lents et bruyants sur les PC classiques.

Compatible avec✓Claude Code~Codex CLI~Cursor

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

Documentation

Vérification de la configuration (Windows)

Installation ou réparation complète (sans intervention, exécution sécurisée, écrit .setup-ok en cas de succès) :

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

Cela affiche SETUP FAILED: <raison> avec le correctif lorsque quelque chose ne peut pas être fait automatiquement.

Configuration connue comme correcte :

Outil	Emplacement
Node.js 22+	winget `OpenJS.NodeJS.LTS` → `C:\Program Files\nodejs`
FFmpeg / FFprobe	winget `Gyan.FFmpeg`
Transcription / voix IA	API Deepgram via `tools/transcribe-deepgram.ps1`, clé dans la variable d'environnement utilisateur `DEEPGRAM_API_KEY`
Chrome	installation système, ou copie privée via `npx --yes hyperframes browser ensure`
Compétences HyperFrames	`%USERPROFILE%\.agents\skills` (+ `.claude\skills`)

N'installez pas whisper.cpp et n'exécutez pas de modèles de transcription locaux (lents et bruyants sur les PC classiques).

Vérification

npx -y hyperframes doctor

Docker, Kokoro (TTS), MusicGen et whisper-cpp ne sont pas nécessaires ici — ignorez-les.

Correctifs courants

Clé Deepgram : l'utilisateur exécute lui-même powershell -NoProfile -ExecutionPolicy Bypass -File tools/set-deepgram-key.ps1 (ne la collez jamais dans le chat). Les scripts lisent la valeur au niveau utilisateur même dans les anciens terminaux.
node / ffmpeg introuvable juste après l'installation : actualisez le PATH dans le terminal ($env:Path = [Environment]::GetEnvironmentVariable('Path','Machine') + ';' + [Environment]::GetEnvironmentVariable('Path','User')) ou redémarrez l'éditeur.
"L'exécution de scripts est désactivée" : appelez toujours les scripts via powershell -NoProfile -ExecutionPolicy Bypass -File ....
Deepgram 401 : clé erronée/expirée — demandez à l'utilisateur de la définir à nouveau. 402/429 : crédits épuisés / limitation de débit.
Mise à jour des compétences / CLI : npx -y hyperframes skills update, npx -y hyperframes upgrade.
Tout élément nécessitant des droits administrateur : fournissez à l'utilisateur la commande exacte à exécuter dans un terminal administrateur.