Instalação
Requisitos
- Node.js 20.11+ (ESM nativo)
- Uma chave de API de tradução (veja abaixo)
Instalar
- npm
- npx (no install)
- pnpm
- yarn
npm install --save-dev i18n-rosetta
npx i18n-rosetta sync
pnpm add -D i18n-rosetta
yarn add --dev i18n-rosetta
Obter uma chave de API
O Rosetta precisa de um backend de tradução. Escolha um:
| Provedor | Variável de ambiente | Melhor para |
|---|---|---|
| OpenRouter (recomendado) | OPENROUTER_API_KEY | Projetos com muito conteúdo, Markdown, mais de 200 modelos |
| Google Translate | GOOGLE_TRANSLATE_API_KEY | Pares de chave-valor em alto volume (mais de 130 idiomas) |
- OpenRouter (recommended)
- Google Translate
O OpenRouter fornece uma API unificada para mais de 200 modelos de LLM. Plano gratuito disponível.
# Sign up at https://openrouter.ai, then:
export OPENROUTER_API_KEY=sk-or-v1-...
Ou adicione ao .env.local:
OPENROUTER_API_KEY=sk-or-v1-your-key-here
Melhor para: projetos com muito conteúdo, tradução de Markdown e projetos que precisam de proteção sensível ao conteúdo (blocos de código, shortcodes, variáveis de interpolação).
export GOOGLE_TRANSLATE_API_KEY=...
Melhor para: pares de strings chave-valor em alto volume (mais de 130 idiomas). Não recomendado para conteúdo em Markdown — o Google Translate não reconhece blocos de código, shortcodes ou variáveis de interpolação.
:::tip Detecção inteligente
Se apenas GOOGLE_TRANSLATE_API_KEY estiver definida (sem chave do OpenRouter), o rosetta alterna automaticamente para o Google Translate. Nenhuma alteração de configuração é necessária.
:::
Verificar instalação
npx i18n-rosetta --help
Você deve ver a lista de comandos disponíveis. Você está pronto para o Início Rápido.