Compilación desde Fuentes

Si deseas realizar cambios en el código, puedes compilar desde las fuentes.

Instala hatch para gestionar las dependencias del proyecto y ejecutar scripts de desarrollo:

pipx install hatch

Clona el repositorio:

git clone https://github.com/LibreTranslate/LibreTranslate.git
cd LibreTranslate

Hatch instalará automáticamente las dependencias requeridas en un entorno virtual y habilitará pre-commit, que se ejecutará antes de cada commit para el formateo. Puedes omitir las comprobaciones de pre-commit al hacer commit si es necesario: git commit --no-verify -m "Fix"

Ejecución en modo de desarrollo:

hatch run dev --debug

Luego abre un navegador web en http://localhost:5000

También puedes iniciar un nuevo shell en un entorno virtual con libretranslate instalado:

hatch shell
libretranslate [args]
# O
python main.py [args]

Todavía puedes usar pip install -e ".[test]" directamente si no quieres usar hatch.

Ejecución de Pruebas

Ejecuta la suite de pruebas y las comprobaciones de linting:

hatch run test

Para ver todos los print() durante la depuración:

hatch run test -s

También puedes ejecutar las pruebas en múltiples versiones de python:

hatch run all:test

Puedes limpiar el entorno virtual con:

hatch env prune

Compilación con Docker

docker build -f docker/Dockerfile [--build-arg with_models=true] -t libretranslate .

Si deseas ejecutar la imagen de Docker en un entorno completamente fuera de línea, debes agregar el parámetro --build-arg with_models=true. De esta manera, los modelos de lenguaje se descargan durante el proceso de compilación de la imagen. De lo contrario, estos modelos se descargan en el primer inicio de la imagen/contenedor.

Ejecuta la imagen compilada:

docker run -it -p 5000:5000 libretranslate [args]

O compila y ejecuta usando Docker Compose:

docker compose up -d --build

Siéntete libre de modificar el archivo docker-compose.yml para adaptarlo a tus necesidades de implementación, o usa un archivo docker-compose.prod.yml adicional para tu configuración de implementación.

Los modelos se almacenan dentro del contenedor en /home/libretranslate/.local/share y /home/libretranslate/.local/cache. Siéntete libre de usar volúmenes si no quieres volver a descargar los modelos cuando se destruye el contenedor. Para actualizar los modelos, usa el argumento --update-models.

FAQ

Entorno Gestionado Externamente

Algunos usuarios pueden encontrar el siguiente error al instalar paquetes:

error: externally-managed-environment

× This environment is externally managed
╰─> To install Python packages system-wide, try apt install
    python3-xyz, where xyz is the package you are trying to
    install.

    …

Esto ocurre cuando tu sistema operativo depende de y gestiona Python para funcionalidades básicas. En este caso, deberías instalar y configurar venv (entornos virtuales) para gestionar las dependencias del proyecto.

Esto evita que los paquetes de pip se instalen a nivel de sistema. De esta manera, no hay riesgos de que los paquetes de pip entren en conflicto entre múltiples proyectos o con el sistema operativo.