// docs / solución-de-problemas
Solución de problemas
Soluciones de raíz para los problemas de configuración más comunes — captura, CUDA, la conexión WebSocket y errores de dependencias — seguidas de la exportación de diagnóstico local-first.
No aparecen subtítulos
Verifica el dispositivo de audio seleccionado en el panel. Si capturas el sonido del escritorio en Windows, asegúrate de haber activado el canal de WASAPI loopback correcto.
Error de CUDA / sin memoria
LiveAudio monitorea la VRAM antes de cada transcripción. Cuando la memoria libre baja de unos 500 MB, libera la caché de CUDA automáticamente y muestra “GPU saturada - VRAM baja”. Si aún así falla: cambia el dispositivo de inferencia de cuda a cpu, o carga un modelo más chico (tiny o base), y cierra otros programas que consuman VRAM (OBS con NVENC, juegos). Actualizar el driver de NVIDIA resuelve la mayoría de los fallos de runtime de CUDA.
“cublas64_12.dll not found” (CUDA)
Es un problema de resolución de DLLs, no una instalación faltante. El extra cu121 trae torch/torchaudio desde download.pytorch.org/whl/cu121 (y cpu desde /whl/cpu); debe seleccionarse exactamente un extra. En Windows, ctranslate2 — el backend de faster-whisper — carga cublas64_12.dll y cuDNN 9 vía el PATH del sistema, no los directorios de DLL de Python, por eso LiveAudio antepone torch/lib al PATH al iniciar (liveaudio/utils/dllpath.py). Si ejecutas desde un entorno propio y aparece este error, asegúrate de que las ruedas de torch CUDA estén instaladas y que torch/lib sea accesible. El stack cu121 fija torch>=2.4,<2.6 (allí no se publican ruedas 2.6, y ≥ 2.4 trae el cuDNN 9 contra el que enlaza ctranslate2). El driver mínimo es 525.
OBS no conecta
Asegúrate de que el motor esté iniciado — el puerto 8765 debe estar a la escucha. Si tu cortafuegos o antivirus bloquea el tráfico local, agrega una regla para permitir conexiones de localhost en el puerto del WebSocket.
No module named 'torch'
Instalador: ejecuta el launcher con --reinstall. Desarrolladores: ejecuta uv sync --extra cpu (o --extra cu121) y luego uv run liveaudio.
El audio se corta o hay silencios largos
Aumenta el valor de detección de silencio (alrededor de 1.0–1.5 s) para que no corte frases con pausas largas a mitad de oración.
Aviso de Windows SmartScreen
Recuperación de instalación y descargas
Los problemas durante el bootstrap de la primera ejecución (o una descarga CUDA interrumpida) se recuperan sin reinstalar desde cero:
| Problema | Qué hacer |
|---|---|
| Descarga interrumpida (instalación CUDA grande) | Simplemente vuelve a ejecutar el launcher. uv cachea por rueda, así que las ruedas completas no se vuelven a descargar; el zip de código se re-baja y se verifica por checksum. |
| “SHA256 mismatch” | La descarga se corrompió o fue manipulada. El launcher reintenta solo (3 intentos con backoff). Los fallos persistentes suelen ser un proxy o antivirus reescribiendo descargas; verifica contra SHA256SUMS.txt. |
| Instalación corrupta / a medias | Ejecuta el launcher con --reinstall — borra app/ y .venv, mantiene tu preferencia de dispositivo y reinstala desde cero. |
| Backend equivocado instalado | Vuelve a ejecutar con --device cpu o --device cuda; el launcher re-sincroniza y persiste la elección. |
| ¿Dónde están los logs? | bootstrap.log en la raíz de instalación (%LOCALAPPDATA%\LiveAudio en Windows, ~/.local/share/liveaudio en Linux, o data/ junto al launcher en modo portable). El diálogo de error también tiene un botón “Open log”. |
Diagnóstico local
LiveAudio incluye diagnóstico local-first — no envía telemetría a ningún lado. Úsalo cuando OBS deja de recibir subtítulos, el ASR se atrasa o el audio reconecta demasiado seguido.
- Cómo: reproduce el problema, pulsa Export diagnostics en la app y revisa el JSON exportado (estados de procesos, tamaños de colas, estados audio/asr/ws).
- Privacidad: la exportación nunca incluye audio crudo ni transcripciones completas, y sanitiza secrets, tokens y rutas sensibles.
| Clave | Valor |
|---|---|
diagnostics_enabled | true / false |
diagnostics_level | minimal / deep |
diagnostics_export_dir | ruta o null |