Translator API playground · Browser AI Kit

Runs in this browser

Interactive playground

No hosted fallback

Use it in your product

Start complete. Customize when you need to.

Components provide the fastest production path. Composables expose the same lifecycle for a UI that is entirely yours.

Vue component

Add a complete translation workspace

Language-pair setup, downloads, swapping, debouncing and copy actions are included.

Vue component

<script setup lang="ts">
import { ref } from "vue";
import { Translator } from "@desource/browser-ai-vue";
import "@desource/browser-ai-vue/assets/lib.css";

const source = ref("Private AI, directly in your browser.");
</script>

<template>
  <Translator
    v-model="source"
    source-language="en"
    target-language="fr" />
</template>

Vue composable

Translate inside any custom UI

Create a language pair from a user action, reuse it, and translate long text in ordered chunks.

Vue composable

<script setup lang="ts">
import { ref } from "vue";
import { useTranslator } from "@desource/browser-ai-vue";

const input = ref("Your changes are saved on this device.");
const output = ref("");
const error = ref("");
// Creating the composable in setup also registers session cleanup.
const ai = useTranslator({ sourceLanguage: "en", targetLanguage: "fr" });
const { isProcessing, interrupt } = ai;

async function run() {
  if (isProcessing.value) return;
  output.value = "";
  error.value = "";
  try {
    if (!ai.isReady.value) await ai.create();
    const result = await ai.translateWithDetails(input.value, { autoCreate: false, chunking: "auto" });
    output.value = result.translation;
  } catch (cause) {
    if (cause instanceof DOMException && cause.name === "AbortError") return;
    error.value = cause instanceof Error ? cause.message : String(cause);
  }
}
</script>

<template>
  <textarea v-model="input" aria-label="Source text" />
  <button :disabled="isProcessing || !input.trim()" @click="run">Translate</button>
  <button :disabled="!isProcessing" @click="interrupt">Stop</button>
  <p v-if="error" role="alert">{{ error }}</p>
  <pre>{{ output }}</pre>
</template>

One contract, native ergonomics

Use the same capability in every supported stack.

Vue composables, React hooks, Svelte stores, Angular signals, Nuxt auto-imports, and the TypeScript core all delegate browser behavior to the same tested runtime.

Vue

Vue component

Use the ready-made component or the matching use* composable.

Vue

<script setup lang="ts">
import { Translator } from "@desource/browser-ai-vue";
import "@desource/browser-ai-vue/assets/lib.css";
</script>

<template><Translator source-language="en" target-language="fr" /></template>

React

React component

The matching hook exposes the same core operations for a custom interface.

React

import { Translator } from "@desource/browser-ai-react";
import "@desource/browser-ai-react/assets/lib.css";

export function Feature() {
  return <Translator sourceLanguage="en" targetLanguage="fr" />;
}

Svelte

Svelte component

Use the component or its create* controller with a readable state store.

Svelte

<script lang="ts">
  import { Translator } from "@desource/browser-ai-svelte";
  import "@desource/browser-ai-svelte/assets/lib.css";
</script>

<Translator sourceLanguage="en" targetLanguage="fr" />

Angular

Angular standalone component

Standalone components pair with signal controllers and BrowserAiService.

Angular

import { Component } from "@angular/core";
import { BrowserAiTranslatorComponent } from "@desource/browser-ai-angular";
import "@desource/browser-ai-angular/assets/lib.css";

@Component({
  standalone: true,
  imports: [BrowserAiTranslatorComponent],
  template: `<browser-ai-translator sourceLanguage="en" targetLanguage="fr" />`
})
export class FeatureComponent {}

Nuxt

Nuxt auto-import

The Nuxt module registers the Vue component on the client and protects SSR.

Nuxt

export default defineNuxtConfig({
  modules: ["@desource/browser-ai-nuxt"]
});

// app/pages/feature.vue
<template><Translator source-language="en" target-language="fr" /></template>

TypeScript core

Framework-neutral controller

Start from a real click, handle browser errors, and release the native session after the result.

TypeScript core

import { createTranslator } from "@desource/browser-ai";

const button = document.createElement("button");
const output = document.createElement("pre");
button.textContent = "Run Translator";
document.body.append(button, output);

button.addEventListener("click", async () => {
  button.disabled = true;
  const api = createTranslator({ sourceLanguage: "en", targetLanguage: "fr" });
  try {
    const result = await api.translate("Your changes are saved on this device.");
    output.textContent = typeof result === "string" ? result : JSON.stringify(result, null, 2);
  } catch (error) {
    output.textContent = error instanceof Error ? error.message : String(error);
  } finally {
    api.dispose();
    button.disabled = false;
  }
});