@rejax/browser-ai v0.0.19
@rejax/browser-ai
A toolkit of browser built-in AI API, including Prompt API, Translation API, Write API, Summarize API, etc.
Installation
npm install @rejax/browser-aiFeatures
- Language Detection
- Translation
- Prompt/Chat Capabilities
- Text Summarization
- Origin Trial Token Setting
Language Detection
The library provides automatic language detection capabilities:
import { detect, checkDetectorUsability } from '@rejax/browser-ai'
// Check if language detection is available
const usability = await checkDetectorUsability()
if (usability.available) {
// Detect language of text
const result = await detect('Hello world')
console.log(result)
// Output: { text: 'en', value: 'en' }
}The detector will use either the Chrome AI API (ai.languageDetector) or Translation API (translation) depending on availability.
Translation
The translation module allows translating text between languages:
import { translate, checkTranslatorUsability, updateTranslator } from '@rejax/browser-ai'
// Check translation availability for language pair
const usability = await checkTranslatorUsability({
sourceLanguage: 'en',
targetLanguage: 'es'
})
if (usability.available) {
// Translate text
const translated = await translate({
text: 'Hello world',
sourceLanguage: 'en',
targetLanguage: 'es'
})
console.log(translated) // "Hola mundo"
}
// Update translator for different languages
await updateTranslator({
sourceLanguage: 'en',
targetLanguage: 'fr'
})Prompt/Chat Capabilities
The library provides access to language model and assistant capabilities:
import { promptStreaming, checkPromptUsability } from '@rejax/browser-ai'
// Check if prompt capabilities are available
const usability = await checkPromptUsability()
if (usability.available) {
// Stream responses from the model
const stream = await promptStreaming('Tell me a joke')
// Handle stream response...
}Text Summarization
Provides text summarization capabilities:
import { summarize, summarizeStreaming, checkSummarizerUsability } from '@rejax/browser-ai'
// Check if summarization is available
const usability = await checkSummarizerUsability()
if (usability.available) {
// Get a summary
const summary = await summarize('Long text to summarize...')
// Or use streaming for real-time results
const stream = await summarizeStreaming('Long text to summarize...')
}Origin Trial Token
Set an Origin Trial token for API access:
import { setOriginTrialToken } from '@rejax/browser-ai'
setOriginTrialToken('your-token-here')API Types
Language Detection
interface DetectionResult {
text: string // Detected language code
value: string // Same as text
}
interface UsabilityResult {
available: boolean
apiPath: string[]
createFuncName: string
}Translation
interface TranslationParams {
sourceLanguage: string
targetLanguage: string
}
interface TranslationRequest extends TranslationParams {
text: string
}
interface TranslationResult {
available: boolean
apiPath: string | string[]
createFuncName: string
canFuncName?: string
msg?: string
}Browser Compatibility
This library requires a browser that supports one or more of:
- Chrome AI API (
window.ai)- Language Model/Assistant API
- Language Detector API
- Summarizer API
- Translation API (
window.translation)
Currently Chrome/Chromium browsers version 120+ are supported.
Error Handling
The library will throw errors if:
- Browser APIs are not available
- Requested language pair is not supported
- Translation fails
- Session initialization fails
- Summarization is not supported
Be sure to wrap API calls in try/catch blocks for proper error handling.
License
MIT
6 months ago
6 months ago
6 months ago
6 months ago
6 months ago
6 months ago
6 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
12 months ago
12 months ago
12 months ago
12 months ago
12 months ago