fast-mlkit-translate-text

A MachineLearning Language Translator

Build Powerful React Native With Greate Language Identifier And Translator Amazing ⚡️

| | MLKitTranslator |
| - | ------------ |
| ⚡️ | Identify Language Immediately over 50 languages supported (full list) |
| 😎 | Lazy loaded. download models when needed |
| 🔄 | Offline-first. no network required for using |
| 📱 | Multiplatform. iOS, Android |
| ⏱ | Fast. Support New Architecture |
| 🔗 | Relational. Built on MLKit Translation foundation |
| ⚠️ | Static typing Full-Support TypeScript |

Why MLKitTranslator?

Key capabilities

- Broad language support Translate between more than 50 different languages. See the complete list.
- Proven translation models Powered by the same models used by the Google Translate app's offline mode.
- Dynamic model management Keep on-device storage requirements low by dynamically downloading and managing language packs.
- Runs on the device Translations are performed quickly, and don't require you to send users' text to a remote server.

Requirements

- React Native 0.71+
- Android: Gradle 8.7+, JDK 17+, compileSdkVersion 35+
- iOS: Xcode 15+, iOS 13.0+

This library supports Android 15's 16 KB page size requirement.

Installation

> yarn add fast-mlkit-translate-text

or

> npm i --save fast-mlkit-translate-text

Usage

Quick example: identify language type

``typescript
import FastTranslator from 'fast-mlkit-translate-text';

const text = "你好，朋友";

FastTranslator.identifyLanguage(text)
.then((result:string) => {
//output: 'en'
})
.catch((err:Error) => {
//handle error
})

`
Translate text example: identify 、download model and translate

etc: you'd like to translate English to Chinese

1️⃣ prepare (when you change the source or target language, you need to call prepare firstly)
`js
import FastTranslator from 'fast-mlkit-translate-text';

await FastTranslator prepare({
source: 'Chinese';
target: 'English';
downloadIfNeeded: true; // set to false if you want to download mannually
});
// await FastTranslator.downloadLanguageModel('Chinese');
// await FastTranslator.downloadLanguageModel('English');
`
Do not translate text if the model is not downloaded
you can check model by func isLanguageDownloaded
`js
FastTranslator.isLanguageDownloaded('Chinese');
FastTranslator.isLanguageDownloaded('English');
`

2️⃣ translate text
`js
await FastTranslator.translate(text);

// 🎉 got it, dude
``

Author and license

FastMLKitTranslateText was created by @yaaliuzhipeng

fast-mlkit-translate-text is available under the MIT license. See the LICENSE file for more info.