Files
renpy-translator/docs/libretranslate.md

2.6 KiB
Raw Blame History

Lokaler LibreTranslate-Server

LibreTranslate stellt eine HTTP-API auf dem eigenen Rechner bereit. Es werden keine Texte an einen externen Übersetzungsdienst gesendet. Die Standardadresse ist http://localhost:5000.

Installation unter Linux

Voraussetzung: Python 3.8 oder neuer. In einem Terminal:

python3 -m venv ~/.local/share/libretranslate-venv
~/.local/share/libretranslate-venv/bin/pip install --upgrade pip libretranslate
~/.local/share/libretranslate-venv/bin/libretranslate

Beim ersten Start werden Sprachmodelle geladen. Für weniger Speicherbedarf kann man nur benötigte Sprachen laden, beispielsweise Englisch und Deutsch:

~/.local/share/libretranslate-venv/bin/libretranslate --load-only en,de

Der Server bleibt im Terminal aktiv. Anschließend in Renpy Translation Helper im Auswahlfeld Provider LibreTranslate (local) wählen. Die voreingestellte lokale URL http://localhost:5000 übernehmen oder anpassen. Die verfügbaren Sprachpaare werden automatisch geladen.

Nur Englisch und Deutsch nachinstallieren

Wurde ein erster Start ohne --load-only abgebrochen, können bereits einige unpassende Modelle installiert sein. Den Server mit Strg+C beenden und die zwei benötigten Richtungen explizit installieren:

~/.local/share/libretranslate-venv/bin/argospm update
~/.local/share/libretranslate-venv/bin/argospm install translate-en_de
~/.local/share/libretranslate-venv/bin/argospm install translate-de_en
~/.local/share/libretranslate-venv/bin/libretranslate --load-only en,de

Mit curl http://127.0.0.1:5000/languages prüfen, ob sowohl en mit Ziel de als auch de mit Ziel en aufgelistet wird. Erst dann kann die App diese Sprachrichtung anbieten.

Nutzung durch andere Anwendungen

Sprachen abfragen:

curl http://localhost:5000/languages

Einen Text übersetzen:

curl -X POST http://localhost:5000/translate \
  -H 'Content-Type: application/json' \
  -d '{"q":"Hello world","source":"en","target":"de","format":"text"}'

Für mehrere Texte kann q ein Array sein:

curl -X POST http://localhost:5000/translate \
  -H 'Content-Type: application/json' \
  -d '{"q":["Hello","Good night"],"source":"en","target":"de","format":"text"}'

Die Antwort enthält translatedText bei mehreren Eingaben ebenfalls als Array.

Hinweis zu AMD-Grafikkarten

LibreTranslate/Argos Translate verwendet regulär die CPU. Die offiziell dokumentierte GPU-Beschleunigung setzt CUDA voraus und ist damit für Nvidia vorgesehen. Eine AMD-GPU wird in diesem Standard-Setup nicht genutzt; für normale Ren'Py-Dialoge ist der CPU-Betrieb dennoch brauchbar.