Installation

Mga Requirement

• Node.js 20.11+ (native ESM)
• Isang translation API key (tingnan sa ibaba)

Install

npm

npm install --save-dev i18n-rosetta

npx (no install)

npx i18n-rosetta sync

pnpm

pnpm add -D i18n-rosetta

yarn

yarn add --dev i18n-rosetta

Kumuha ng API Key

Kailangan po ng Rosetta ng translation backend. Pumili ng isa:

Provider	Environment Variable	Best For
OpenRouter (inirerekomenda)	OPENROUTER_API_KEY	Mga content-heavy project, Markdown, 200+ models
Gemini (free tier)	GEMINI_API_KEY	Zero-cost na simula, magandang quality
OpenAI	OPENAI_API_KEY	Direct GPT-4o access
Anthropic	ANTHROPIC_API_KEY	Direct Claude access, nuanced na text
DeepL	DEEPL_API_KEY	Mga European language, built-in formality
Google Translate	GOOGLE_TRANSLATE_API_KEY	High-volume key-value pairs, 130+ na language
Microsoft Translator	MICROSOFT_TRANSLATOR_API_KEY	Azure, 100+ na language
LibreTranslate	LIBRETRANSLATE_API_URL	Self-hosted, privacy-first

OpenRouter (recommended)

Nagpo-provide po ang OpenRouter ng unified API para sa 200+ LLM models. May available na free tier.

# Sign up at https://openrouter.ai, then:
export OPENROUTER_API_KEY=sk-or-v1-...

O kaya i-add sa .env.local:

OPENROUTER_API_KEY=sk-or-v1-your-key-here

Best for: mga content-heavy project, Markdown translation, at mga project na nangangailangan ng content-aware shielding (code blocks, shortcodes, interpolation variables).

Google Translate

export GOOGLE_TRANSLATE_API_KEY=...

Best for: high-volume key-value string pairs (130+ na language). Hindi inirerekomenda para sa Markdown content — walang awareness ang Google Translate sa mga code block, shortcode, o interpolation variable.

:::tip Smart detection Kung GOOGLE_TRANSLATE_API_KEY lang ang naka-set (walang OpenRouter key), mag-a-auto-switch po ang rosetta sa Google Translate. Wala nang kailangang baguhin sa config. :::

I-verify ang Installation

npx i18n-rosetta --help

Dapat makita niyo po ang listahan ng mga available command. Ready na po kayo para sa Quick Start.