Instalando Coqui TTS sin morir en el intento

20 febrero, 2025 Carlos Dk

Si alguna vez intentaste instalar Coqui TTS y terminaste peleando con versiones de Python, PyTorch y modelos que no se descargan, este post es para ti (y para mi yo del futuro, que seguro se olvidará de todo esto en unos meses).

Aquí va la guía definitiva para instalar Coqui TTS y evitar errores molestos.

1️⃣ Primero, actualizar las herramientas de Python

Antes de empezar, asegúrate de que pip, setuptools, wheel y packaging estén al día:

bashCopiarEditarpip install --upgrade pip setuptools wheel packaging

Si esto falla, algo anda mal en tu entorno. Revisa que estás usando la versión correcta de Python.

2️⃣ Instalar (o reinstalar) Coqui TTS

bashCopiarEditarpip install --upgrade --force-reinstall TTS

A veces la instalación se corrompe. Si pasa eso, puedes limpiar la caché y reinstalarlo:

bashCopiarEditarrm -rf ~/.cache/TTS
pip install --upgrade --force-reinstall TTS

3️⃣ Si falla con PyTorch 2.6 (error de `weights_only`)

En versiones recientes, PyTorch cambió cómo carga modelos y eso rompe Coqui TTS. Si ves un error como este:

luaCopiarEditar_pickle.UnpicklingError: Weights only load failed...

Solución: bajar a PyTorch 2.0.1:

bashCopiarEditarpip uninstall -y torch
pip install torch==2.0.1

4️⃣ Verificar que los modelos estén disponibles

bashCopiarEditartts --list_models

Si el modelo que necesitas no está en la lista, probablemente la instalación no fue completa o necesitas reinstalarlo.

5️⃣ Probar con un texto básico

Para asegurarte de que todo funciona, ejecuta:

bashCopiarEditartts --text "Hola, esto es una prueba" --model_name "tts_models/multilingual/multi-dataset/your_tts"

Si no suena nada o hay errores, revisa:

Que el modelo que elegiste esté disponible en tts --list_models.
Que no haya errores de permisos en la ruta de salida.
Que el modelo haya sido descargado correctamente.

Extra: Usando una voz personalizada

Si tienes un archivo de voz clonada (por ejemplo, clonacarlos.wav), puedes usarlo así:

bashCopiarEditartts --text "Hola, esto es una prueba con voz personalizada" \
    --model_name "tts_models/multilingual/multi-dataset/your_tts" \
    --speaker_wav "/ruta/a/clonacarlos.wav" \
    --out_path "salida.mp3"

Si falla, prueba primero sin --speaker_wav y luego agrégalo.

Conclusión

Instalar Coqui TTS puede ser un dolor si no sabes qué versiones usar. Con estos pasos, deberías tenerlo funcionando sin problemas.

Si algo se rompe en el futuro… bueno, al menos ahora tengo este post para recordarlo. 😅

🚀 Guárdalo, porque seguro lo vas a necesitar! #TTS #AI #DevTips