README.md

Bergamot Translator

Bergamot translator provides a unified API for (Marian NMT framework based) neural machine translation functionality in accordance with the Bergamot project that focuses on improving client-side machine translation in a web browser.

Build Instructions

Build Natively

Create a folder where you want to build all the artifacts (build-native in this case) and compile

mkdir build-native
cd build-native
cmake ../
make -j2

Build WASM

Prerequisite

Building on wasm requires Emscripten toolchain. It can be downloaded and installed using following instructions:

• Get the latest sdk: git clone https://github.com/emscripten-core/emsdk.git
• Enter the cloned directory: cd emsdk
• Install the sdk: ./emsdk install 3.1.8
• Activate the sdk: ./emsdk activate 3.1.8
• Activate path variables: source ./emsdk_env.sh

Compile

To build a version that translates with higher speeds on Firefox Nightly browser, follow these instructions:

1. Create a folder where you want to build all the artifacts (build-wasm in this case) and compile

   mkdir build-wasm
   cd build-wasm
   emcmake cmake -DCOMPILE_WASM=on ../
   emmake make -j2

   The wasm artifacts (.js and .wasm files) will be available in the build directory ("build-wasm" in this case).

2. Enable SIMD Wormhole via Wasm instantiation API in generated artifacts

   bash ../wasm/patch-artifacts-enable-wormhole.sh

3. Patch generated artifacts to import GEMM library from a separate wasm module

   bash ../wasm/patch-artifacts-import-gemm-module.sh

To build a version that runs on all browsers (including Firefox Nightly) but translates slowly, follow these instructions:

1. Create a folder where you want to build all the artifacts (build-wasm in this case) and compile

   mkdir build-wasm
   cd build-wasm
   emcmake cmake -DCOMPILE_WASM=on -DWORMHOLE=off ../
   emmake make -j2

2. Patch generated artifacts to import GEMM library from a separate wasm module

   bash ../wasm/patch-artifacts-import-gemm-module.sh

Recompiling

As long as you don't update any submodule, just follow Compile steps.
If you update a submodule, execute following command in repository root folder before executing Compile steps.

git submodule update --init --recursive

How to use

Using Native version

The builds generate library that can be integrated to any project. All the public header files are specified in src folder.
A short example of how to use the APIs is provided in app/main.cpp file.

Using WASM version

Please follow the README inside the wasm folder of this repository that demonstrates how to use the translator in JavaScript.