Verificación de configuración (Windows)
Instala o repara todo (sin intervención, seguro de re-ejecutar, escribe .setup-ok al terminar correctamente):
powershell -NoProfile -ExecutionPolicy Bypass -File tools/setup.ps1
Si algo no puede hacerse automáticamente, muestra SETUP FAILED: <razón> con la solución.
Configuración correcta conocida:
| Herramienta | Ubicación |
|---|---|
| Node.js 22+ | winget OpenJS.NodeJS.LTS → C:\Program Files\nodejs |
| FFmpeg / FFprobe | winget Gyan.FFmpeg |
| Transcripción / Voz IA | API de Deepgram mediante tools/transcribe-deepgram.ps1, clave en variable de entorno del usuario DEEPGRAM_API_KEY |
| Chrome | instalación del sistema, o una copia privada desde npx --yes hyperframes browser ensure |
| Habilidades de HyperFrames | %USERPROFILE%\.agents\skills (+ .claude\skills) |
No instales whisper.cpp ni ejecutes modelos de transcripción locales (lentos y ruidosos en PCs típicos).
Verificar
npx -y hyperframes doctor
Docker, Kokoro (TTS), MusicGen y whisper-cpp no son necesarios aquí — ignóralos.
Soluciones comunes
- Clave de Deepgram: el usuario ejecuta
powershell -NoProfile -ExecutionPolicy Bypass -File tools/set-deepgram-key.ps1por sí mismo (nunca la pegues en el chat). Los scripts leen el valor del ámbito de usuario incluso en terminales viejos. node/ffmpegno encontrados justo después de la configuración: actualiza el PATH en la terminal ($env:Path = [Environment]::GetEnvironmentVariable('Path','Machine') + ';' + [Environment]::GetEnvironmentVariable('Path','User')) o reinicia el editor.- "running scripts is disabled": llama siempre a los scripts mediante
powershell -NoProfile -ExecutionPolicy Bypass -File .... - Deepgram 401: clave incorrecta/expirada — pídele al usuario que la configure de nuevo. 402/429: sin crédito / límite de velocidad alcanzado.
- Actualizar habilidades / CLI:
npx -y hyperframes skills update,npx -y hyperframes upgrade. - Cualquier cosa que necesite permisos de administrador: dale al usuario el comando exacto para ejecutar en una terminal de administrador.