Guía de WhisperX
Instalar WhisperX: entorno local y solución de problemas
Prepara un entorno Python aislado, CPU o GPU compatible y FFmpeg. Consulta los requisitos actuales del proyecto original.
Equipo de WhisperX · Revisado el 15 de octubre de 2026
Consulta los requisitos actuales
Lee el README y las instrucciones de la versión elegida antes de seleccionar Python, PyTorch o CUDA. Las dependencias cambian; esta guía no garantiza que todos los comandos funcionen en tu sistema.
Aísla el entorno
Crea un entorno virtual nuevo y guarda la versión instalada y el archivo de dependencias. Sigue las instrucciones de una versión estable si necesitas reproducibilidad.
Comprueba CPU, GPU y FFmpeg
Puedes usar CPU. La aceleración con GPU necesita controladores y versiones compatibles; instalar CUDA por sí solo no basta. FFmpeg permite leer los formatos multimedia habituales. Prueba primero con un archivo corto.
Configura la identificación de hablantes al final
Comprueba primero que la transcripción y la alineación funcionan. Después configura el acceso a los modelos según el proyecto original, acepta sus condiciones con tu cuenta y guarda los tokens fuera del repositorio.
Revisa cada componente por separado
Comprueba el ejecutable y el entorno si no se encuentra el comando; el controlador y las bibliotecas si falla CUDA; el tamaño del lote si falta memoria, y los permisos si se deniega un modelo. Elimina datos privados y tokens de los registros que compartas.
Elige el entorno que necesitas
La instalación local te da control sobre la configuración y ubicación de los datos. El servicio alojado se ocupa del entorno cuando prefieres subir, revisar y exportar sin mantenerlo.
python -m venv .venv
# Activa .venv con el comando de tu shell
python -m pip install --upgrade pip
python -m pip install whisperx
whisperx recording.wav --device cpu --compute_type int8