Instalação

Requisitos

• Node.js 20.11+ (ESM nativo)
• Uma chave de API de tradução (veja abaixo)

Instalar

npm

npm install --save-dev champollion

npx (no install)

npx champollion sync

pnpm

pnpm add -D champollion

yarn

yarn add --dev champollion

Obter uma Chave de API

Champollion 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, 200+ modelos
Gemini (camada gratuita)	GEMINI_API_KEY	Começar sem custos, boa qualidade
OpenAI	OPENAI_API_KEY	Acesso direto ao GPT-4o
Anthropic	ANTHROPIC_API_KEY	Acesso direto ao Claude, texto nuançado
DeepL	DEEPL_API_KEY	Idiomas europeus, formalidade integrada
Google Translate	GOOGLE_TRANSLATE_API_KEY	Pares chave-valor em alto volume, 130+ idiomas
Microsoft Translator	MICROSOFT_TRANSLATOR_API_KEY	Azure, 100+ idiomas
LibreTranslate	LIBRETRANSLATE_API_URL	Auto-hospedado, privacidade em primeiro lugar

OpenRouter (recommended)

OpenRouter fornece uma API unificada para 200+ modelos LLM. Camada gratuita disponível.

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

Ou adicione a .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 consciente de conteúdo (blocos de código, shortcodes, variáveis de interpolação).

Google Translate

export GOOGLE_TRANSLATE_API_KEY=...

Melhor para: pares de strings chave-valor em alto volume (130+ idiomas). Não recomendado para conteúdo Markdown — Google Translate não tem consciência 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 OpenRouter), champollion muda automaticamente para Google Translate. Nenhuma mudança de configuração necessária. :::

Verificar Instalação

npx champollion --help

Você deve ver a lista de comandos disponíveis. Você está pronto para o Início Rápido.