LocalMode
Chrome AI

Translation

Translate text using Chrome built-in Gemini Nano

Translation

Chrome AI provides instant text translation via the built-in Translator API. No model download required.

See it in action

Try Translator and Smart Writer for working demos.

Basic Usage

import { translate } from '@localmode/core';
import { chromeAI } from '@localmode/chrome-ai';

const { translation } = await translate({
  model: chromeAI.translator({ targetLanguage: 'es' }),
  text: 'Hello, how are you?',
});

console.log(translation); // "Hola, ¿cómo estás?"

Language Configuration

// English to German
const deTranslator = chromeAI.translator({
  sourceLanguage: 'en',
  targetLanguage: 'de',
});

// English to French
const frTranslator = chromeAI.translator({
  sourceLanguage: 'en',
  targetLanguage: 'fr',
});

Override Language at Call Time

const translator = chromeAI.translator();

const { translation } = await translate({
  model: translator,
  text: 'Good morning',
  sourceLanguage: 'en',
  targetLanguage: 'ja',
});

Batch Translation

import { translateMany } from '@localmode/core';

const { translations } = await translateMany({
  model: chromeAI.translator({ targetLanguage: 'de' }),
  texts: ['Hello', 'Goodbye', 'Thank you'],
});

console.log(translations); // ["Hallo", "Auf Wiedersehen", "Danke"]

Session Caching

The Chrome AI translator caches sessions per language pair. Multiple translations with the same pair reuse the same session for efficiency.

const translator = chromeAI.translator();

// First call creates the en→es session
await translate({ model: translator, text: 'Hello', targetLanguage: 'es' });

// Second call reuses the cached session (instant)
await translate({ model: translator, text: 'Goodbye', targetLanguage: 'es' });

// Different pair creates a new session
await translate({ model: translator, text: 'Hello', targetLanguage: 'fr' });

For full API reference, options, and result types, see the Core Translation guide.

Showcase Apps

AppDescriptionLinks
TranslatorTranslate text using Chrome AI Translation APIDemo · Source
Smart WriterChrome AI translation with provider fallbackDemo · Source

On this page