Files
libretranslate/README.md
2026-03-29 22:08:42 -04:00

1.7 KiB

libretranslate

Self-hosted LibreTranslate deployment — a free, open-source machine translation API. Used for translating church names, addresses, and mass schedule text in the ScraperControl pipeline.

Service

Service Port Description
libretranslate 150005000 LibreTranslate translation API

Loaded Languages

Only these languages are loaded at startup (LT_LOAD_ONLY):

Code Language
en English
th Thai
tl Filipino (Tagalog)
id Indonesian
ms Malay

These cover the Southeast Asian language churches targeted by ScraperControl importers (import-mass-schedules-ph.ts, import-philmass.ts).

API

Translate text:

curl -X POST http://192.168.0.241:15000/translate \
  -H "Content-Type: application/json" \
  -d '{"q": "Misa ng Bata", "source": "tl", "target": "en"}'

List available languages:

curl http://192.168.0.241:15000/languages

Web UI: http://192.168.0.241:15000 (enabled)

Running

docker compose up -d

Note: First startup downloads language models (~several minutes). The healthcheck has a 300 s start period to account for this.

Data Persistence

Language models and translation data are persisted in the Docker volume libretranslate_data (/home/libretranslate/.local).

Deployment

Runs on 192.168.0.241 (albert-MacBookPro Linux server).

Docker Compose: /opt/docker/libretranslate/docker-compose.yml

Endpoint URL
Translation API http://192.168.0.241:15000
Web UI http://192.168.0.241:15000