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 |
| Gemini (plano gratuito) | GEMINI_API_KEY | Início sem custo, boa qualidade |
| OpenAI | OPENAI_API_KEY | Acesso direto ao GPT-4o |
| Anthropic | ANTHROPIC_API_KEY | Acesso direto ao Claude, textos com nuances |
| DeepL | DEEPL_API_KEY | Idiomas europeus, formalidade integrada |
| Google Translate | GOOGLE_TRANSLATE_API_KEY | Grande volume de pares chave-valor, mais de 130 idiomas |
| Microsoft Translator | MICROSOFT_TRANSLATOR_API_KEY | Azure, mais de 100 idiomas |
| LibreTranslate | LIBRETRANSLATE_API_URL | Auto-hospedado, foco em privacidade |
- OpenRouter (recommended)
- Google Translate
O OpenRouter fornece uma API unificada para mais de 200 modelos 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: grande volume de pares de strings chave-valor (mais de 130 idiomas). Não recomendado para conteúdo em Markdown — o Google Translate não tem reconhecimento de blocos de código, shortcodes ou variáveis de interpolação.
:::tip Detecção inteligente
Se apenas GOOGLE_TRANSLATE_API_KEY estiver definido (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ê deverá ver a lista de comandos disponíveis. Você está pronto para o Início Rápido.