# Solución de problemas (Windows)

## Instalación

**`npm` o `node` no se reconoce:** instala Node.js LTS (22.4 o superior), abre PowerShell nuevo y prueba `node --version`.

**`py` o `python` no existe:** reinstala Python compatible con Piper, activa PATH y vuelve a abrir consola.

**PowerShell bloquea .ps1:** ejecuta `Set-ExecutionPolicy -Scope Process Bypass` **solo** dentro de la sesión actual y comprueba qué script vas a ejecutar.

**`npm install` falla:** revisa conexión, antivirus, permisos y versión de Node; no ejecutes como administrador si no es necesario.

**`piper-tts` falla:** comprueba que el Python seleccionado tenga soporte para la versión del paquete; crea de nuevo `.venv` si cambiaste de intérprete.

## Voz e IA

**Ollama no responde:** abre Ollama y comprueba `ollama list`, `ollama pull qwen2.5:3b` y `scripts/probar_ollama.ps1`.

**Piper dice voz no encontrada:** ejecuta `scripts/descargar_voz.ps1` y confirma que existen `voices/NOMBRE.onnx` y `voices/NOMBRE.onnx.json`.

**La voz no es femenina:** el timbre depende del modelo, no del prompt de IA; escucha muestras en la web de Piper y cambia `piper.voice` por otro modelo descargado cuya licencia/voz hayas comprobado.

**No hay audio en OBS/LIVE Studio:** comprueba salida Windows, volumen, mezclador, fuente de audio del escritorio y rutas de captura. La cámara virtual no envía audio.

**La IA responde lento:** limita tokens, baja complejidad del avatar y ajusta o cambia el modelo local; GPU integrada puede afectar rendimiento.

## TikFinity y TikTok

**WebSocket ECONNREFUSED:** abre TikFinity Desktop; debe ejecutarse en el mismo PC y habilitar API local. Revisa puerto 21213.

**Conecta, pero no llegan comentarios:** verifica que haya un LIVE en marcha y TikFinity esté conectado al canal; habilita `logRawEvents` para revisar nombres/campos concretos.

**Habla varias veces por regalo:** revisa si la versión de TikFinity envía `repeatEnd`/`streakEnd` y adapta el filtro; usa cooldowns si hay rachas duplicadas.

**No se puede pulsar Go LIVE:** tu cuenta debe tener acceso a las funciones LIVE de escritorio. No se soluciona modificando el ZIP.

**No funciona OBS Virtual Camera:** inicia la cámara desde OBS, revisa permisos Windows y si LIVE Studio admite cámaras virtuales en tu versión; si no, usa una fuente de captura oficial permitida.

## VNyan y OBS

**La API responde, pero el avatar no se mueve:** no existe o no está conectado el `API Message node` correcto con la acción que envía `src/avatar.mjs`.

**La boca no se mueve:** activa y configura la sincronización labial de VNyan; las acciones HTTP solo indican inicio/fin de voz.

**El overlay queda en esperando conexión:** inicia Node y abre `http://127.0.0.1:8787/health` en el navegador; comprueba puerto y firewall.

**OBS muestra ventana negra:** comprueba el método de captura de VNyan, la aceleración por hardware y los permisos; prueba captura de pantalla temporal para diagnosticar, evitando mostrar datos privados.

**`npm run demo` no termina:** escribe `salir`, presiona Enter y, si fuera necesario, presiona `Ctrl+C`.

## Diagnóstico rápido

```powershell
.\scripts\comprobar_sistema.ps1
npm run check
npm test
.\scripts\probar_ollama.ps1
.\scripts\probar_voz.ps1
npm run demo
```

### Si necesitas ayuda

Copia **solo** mensajes de error sin credenciales ni datos de espectadores, e indica tu versión de Windows, Node, Python, OBS, TikFinity, VNyan y los pasos realizados.