LibreTranslate: tu propio traductor con API, en local y sin Google

“Olvídate de Google Translate”, abría Guillermo Casaus en X. El proyecto del que hablaba no es nuevo: LibreTranslate lleva en GitHub desde diciembre de 2020 y supera las 16.900 estrellas. Pero sigue siendo una de las respuestas más sencillas a una pregunta que vuelve cada vez que alguien integra traducción en un producto: ¿de verdad tengo que mandar el texto de mis usuarios a Google?

Qué es

LibreTranslate es una API de traducción automática libre que alojas tú. No llama a Google, Azure ni DeepL: su motor es Argos Translate, una librería open source con modelos de traducción que se ejecutan en tu máquina. Una vez descargados los paquetes de idioma, funciona sin conexión.

Lo que ofrece:

• Detección automática del idioma de origen.
• Traducción de texto y de ficheros.
• API REST con endpoints para traducir, detectar y listar idiomas.
• Interfaz web para usarlo como un traductor normal.
• API keys y límites por clave si lo expones a otros.

El tuit habla de “más de 40 idiomas”. La cifra exacta depende de los paquetes de Argos que instales, así que consulta el endpoint /languages de tu instancia en lugar de fiarte de un número.

Cómo se instala

La forma más rápida:

pip install libretranslate
libretranslate

Levanta la API y la interfaz web en http://localhost:5000. La primera ejecución descarga los modelos de idioma, así que tarda un rato. También hay imagen oficial de Docker, que es lo recomendable si lo vas a dejar corriendo en un servidor.

Para traducir desde tu código:

curl -X POST http://localhost:5000/translate \
  -d q="Hello, world" -d source=en -d target=es

Los endpoints principales:

Si no quieres alojarlo, la instancia oficial de libretranslate.com acepta las mismas peticiones con un parámetro api_key, que se obtiene en su portal. En ese caso el texto sí sale de tu máquina, que es justo lo que querías evitar.

Dónde encaja

LibreTranslate tiene sentido cuando la privacidad o el coste pesan más que la calidad máxima:

• Datos sensibles: documentos internos, tickets de soporte o conversaciones que no pueden salir de tu infraestructura.
• Volumen alto: miles de traducciones al día, sin coste por carácter.
• Entornos sin red: equipos aislados o aplicaciones de escritorio que deben funcionar sin conexión.
• Agentes y automatizaciones: un paso de traducción barato en un flujo de n8n o dentro de un agente, sin gastar tokens de un LLM grande en algo que no los necesita. Es la misma lógica que poner un clasificador pequeño delante de tu agente.

Los límites

• Calidad por debajo de DeepL y Google. Los modelos de Argos son pequeños y muchos pares de idiomas pasan por el inglés como intermedio. En textos cortos y técnicos rinde bien; en textos largos, literarios o con matices, se nota. Un LLM local de tamaño medio suele traducir mejor, a cambio de mucho más hardware.
• La primera carga pesa. Cada paquete de idioma ocupa espacio en disco y la memoria crece con los idiomas que cargues. Instala solo los que necesites.
• Licencia AGPL-3.0. Puedes usarlo en un producto comercial, pero si modificas LibreTranslate y lo ofreces como servicio por red, tienes que publicar tus cambios. Es la misma licencia que tiene httpSMS, y conviene revisarla con quien lleve lo legal.
• Marca registrada. El nombre y el logo tienen sus propias pautas de uso: si montas una instancia pública, no la presentes como la oficial.

Ninguna de estas limitaciones es nueva, y por eso el proyecto sigue vivo cinco años después: no compite con DeepL en calidad, sino en ser tuyo.