How wzhy233/opentranslatorlite works
OpenTranslatorLite is an offline Java translation library backed by a CTranslate2 Python worker. Its main workflow initializes the runtime and cache, then accepts synchronous, asynchronous, or batch translation requests through Translator; translations use cached results where available and otherwise go through the model bridge to the worker. Setup checks, configuration, model downloads, and the optional full-build setup UI are separate supporting capabilities. Edges reflect shown calls or documented behavior; unsampled implementation details are omitted rather than inferred.
Main entry points: RuntimeManager.java Runtime manager · Translator.java Translator API · TranslationModel.java Model bridge · SetupWizard.java Setup wizard
Components 17
Translation API
- Translator API
src/main/java/io/github/wzhy233/open_translator/Translator.java
Translation Engine
- Model bridge
src/main/java/io/github/wzhy233/open_translator/model/TranslationModel.java - CTranslate2 worker
src/main/resources/python/ctranslate2_worker.py - Local model assets
- Build metadata
src/main/java/io/github/wzhy233/open_translator/BuildInfo.java
Runtime Setup
- Runtime manager
src/main/java/io/github/wzhy233/open_translator/runtime/RuntimeManager.java - Setup status
src/main/java/io/github/wzhy233/open_translator/setup/SetupStatus.java - Setup wizard
src/full/java/io/github/wzhy233/open_translator/setup/SetupWizard.java - Wizard launcher
src/full/java/io/github/wzhy233/open_translator/setup/SetupWizardLauncher.java - Model downloader
src/main/resources/python/ctranslate2_model_setup.py
Configuration and State
- Translation cache
src/main/java/io/github/wzhy233/open_translator/cache/CacheManager.java - Cache files
- Configuration manager
src/main/java/io/github/wzhy233/open_translator/config/ConfigManager.java - Config files
Other components
- Java caller
- Hugging Face Hub
- Python runtime
Connections 19
- Java caller → Translator API: calls translate
README.md - Translator API → Translation cache: checks and stores
src/main/java/io/github/wzhy233/open_translator/Translator.java - Translator API → Model bridge: initializes model
src/main/java/io/github/wzhy233/open_translator/Translator.java - Translation cache → Cache files: reads and writes
src/main/java/io/github/wzhy233/open_translator/cache/CacheManager.java - Model bridge → Runtime manager: checks readiness
src/main/java/io/github/wzhy233/open_translator/model/TranslationModel.java - Model bridge → CTranslate2 worker: starts and requests
src/main/java/io/github/wzhy233/open_translator/model/TranslationModel.java - CTranslate2 worker → Local model assets: loads model assets
src/main/resources/python/ctranslate2_worker.py - Runtime manager → Setup status: populates status
src/main/java/io/github/wzhy233/open_translator/runtime/RuntimeManager.java - Runtime manager → Configuration manager: reads and saves
src/main/java/io/github/wzhy233/open_translator/runtime/RuntimeManager.java - Configuration manager → Config files: reads and writes
src/main/java/io/github/wzhy233/open_translator/config/ConfigManager.java - Runtime manager → Setup wizard: launches optionally
src/main/java/io/github/wzhy233/open_translator/runtime/RuntimeManager.java - Setup wizard → Runtime manager: runs setup actions
src/full/java/io/github/wzhy233/open_translator/setup/SetupWizard.java - Wizard launcher → Runtime manager: inspects runtime
src/full/java/io/github/wzhy233/open_translator/setup/SetupWizardLauncher.java - Wizard launcher → Setup wizard: opens wizard
src/full/java/io/github/wzhy233/open_translator/setup/SetupWizardLauncher.java - Runtime manager → Model downloader: runs downloader
src/main/java/io/github/wzhy233/open_translator/runtime/RuntimeManager.java - Model downloader → Hugging Face Hub: downloads snapshots
src/main/resources/python/ctranslate2_model_setup.py - Runtime manager → Python runtime: checks and runs
src/main/java/io/github/wzhy233/open_translator/runtime/RuntimeManager.java - Model bridge → Python runtime: starts worker process
src/main/java/io/github/wzhy233/open_translator/model/TranslationModel.java - Translator API → Build metadata: reads build details
src/main/java/io/github/wzhy233/open_translator/Translator.java