loudness.ai

Guía

Texto a voz local y gratuito para LibreChat

LibreChat lee los mensajes en voz alta con cualquier servidor de voz compatible con OpenAI. Con loudness-tts, las voces funcionan en tu propio equipo, gratis. Editas librechat.yaml una vez y reinicias LibreChat.

Actualizada el 16 de octubre de 2026

  1. 1Inicia el servidor de voz

    Docker es lo más sencillo: la imagen incluye FFmpeg y LibreChat reproduce audio MP3.

    docker run -d --name loudness-tts -p 8880:8880 -v loudness-tts:/data ghcr.io/loudness-ai/loudness-tts

    O con Python, después de instalar FFmpeg (consulta la guía de instalación):

    python -m pip install loudness-tts
    loudness-tts serve --host 0.0.0.0 --port 8880 --api-key elige-una-clave
  2. 2Añade los ajustes de voz a librechat.yaml

    speech:
      tts:
        allowedAddresses:
          - "host.docker.internal:8880"
        openai:
          url: "http://host.docker.internal:8880/v1/audio/speech"
          apiKey: "${TTS_API_KEY}"
          model: "tts-1"
          voices: ["best:es-ES", "best:es-MX", "nova", "onyx"]

    La url es la dirección completa de voz, terminada en /v1/audio/speech. LibreChat bloquea las direcciones de tu propia red salvo que aparezcan en allowedAddresses, escritas solo como host y puerto. Solo se pueden elegir las voces de la lista.

  3. 3Define la clave de API

    En el archivo .env de LibreChat, añade la clave a la que se refieren los ajustes: la que pasaste a --api-key, o cualquier texto si el servidor no tiene clave.

    TTS_API_KEY=elige-una-clave
  4. 4Reinicia LibreChat

    docker compose down
    docker compose up -d

    LibreChat lee librechat.yaml al arrancar. Con Docker, el archivo debe estar montado en el contenedor api, como explica la documentación de voz de LibreChat (en inglés).

  5. 5Activa el texto a voz

    En LibreChat, abre Settings → Speech (Configuración → Voz en la interfaz en español), activa Text to Speech, elige el motor OpenAI y una voz de tu lista. Después, usa el botón de lectura en voz alta bajo un mensaje.

  6. 6Opcional: ejecuta el servidor dentro del Docker Compose de LibreChat

    Añade loudness-tts a docker-compose.override.yml, junto a LibreChat:

    services:
      loudness-tts:
        image: ghcr.io/loudness-ai/loudness-tts
        volumes: ["loudness-tts:/data"]
    volumes:
      loudness-tts:

    Después, usa url: "http://loudness-tts:8880/v1/audio/speech" y allowedAddresses: ["loudness-tts:8880"].

Problemas habituales

«Voice … is not available»

La voz elegida debe estar en la lista voices de librechat.yaml. Añádela y reinicia LibreChat.

Se bloquean las peticiones al servidor

Añade el host y el puerto del servidor, sin http:// ni ruta, en speech.tts.allowedAddresses.

No hay sonido ni error

LibreChat reproduce MP3. Usa la imagen de Docker o instala FFmpeg en el ordenador donde funciona el servidor de Python.

Otros idiomas

Añade a la lista identificadores de voz como es_ES-mls_9972-low o best:es-MX. loudness-tts voices --language es muestra los identificadores. Los nombres de voz de OpenAI corresponden a buenas voces en inglés (EE. UU.): nova, shimmer, coral, sage y marin son femeninas; echo, onyx, ash, ballad, verse y cedar son masculinas; alloy y fable son las mejores en general.

Siguientes pasos

Más guías

Todas las guías para desarrolladores

Más de Loudness.ai

Inicia sesión en Loudness.ai