Linha de comando

Um pacote Python sem dependências. Sem chave, ele roda como a demonstração gratuita: 10.000 caracteres por arquivo, até 8 idiomas por execução.

Executar

pip install kaeris
kaeris translate en.json --langs de,ja

Saída (resumida)

→ no key: free demo limits 10,000 chars per file, 8 languages per run, get a key: kaeris.dev/developer
→ Translating en.json → de, ja
✓ Wrote 2 file(s) to /home/you/app
/home/you/app/de.json
/home/you/app/ja.json
✓ Translation QA: no placeholder loss, no overflow risks

Próximos comandos

Comando	O que faz
`kaeris init`	Escreve `kaeris.json` com seu arquivo de origem, idiomas e pasta de saída, para que `kaeris translate` rode sem flags. `--preset` preenche para i18next, react-i18next, next-intl, react-intl, vue-i18n ou flutter-arb.
`kaeris translate --only-new`	Traduz apenas chaves novas e editadas. `kaeris.lock` ao lado da origem lembra o que foi feito. JSON e ARB.
`kaeris check`	Encontra traduções quebradas na sua máquina, sem chave. Sem Python: `npx kaeris check` (Node 18+). Detalhes da verificação.
`kaeris languages`	Exibe os 46 códigos de idioma.
`kaeris quota`	Quanto do volume deste mês resta na sua chave.

Flags principais

Flag	Significado
`--langs de,ja`	Idiomas de destino, separados por vírgula. Forma curta `-l`.
`--out locales`	Onde escrever os arquivos. Padrão: ao lado da origem.
`--verify`	Traduz cada resultado de volta para o inglês e grava `verify.json`, para você conferir o significado.
`--keep 'KAERIS,GitHub'`	Palavras que ficam como estão em todos os idiomas, como nomes de marca.
`--context 'a bank app'`	Uma linha sobre seu aplicativo. Ajuda com palavras que têm dois significados.
`--tone formal`	`neutral`, `formal` ou `casual`.
`--model openai/gpt-4.1`	Lifetime: o modelo do OpenRouter usado na tradução. Um por idioma: `models` em `kaeris.json`. Nos outros planos o pedido é recusado com o motivo.
`--key`	Sua chave de API. Ou defina `KAERIS_API_KEY`, que é mais seguro: uma chave digitada após `--key` permanece no histórico do seu shell e aparece na lista de processos.
`--source-lang en`	Idioma do arquivo de origem. Padrão `en`; também reconhece estruturas `locales/<lang>/<namespace>.json`.
`--back-lang en`	Idioma para o qual `--verify` traduz de volta. Padrão `en`.
`--lock PATH`	Onde fica o `kaeris.lock`. Padrão: ao lado do arquivo de origem.
`--assume-current`	Primeira execução com `--only-new` em um projeto que já está traduzido: confia nas traduções existentes em vez de traduzir tudo novamente.
`--tm PATH`	Arquivo de memória de tradução, por padrão `kaeris-tm.json` ao lado do arquivo de origem. Ele reutiliza traduções pelo texto, então uma chave renomeada ou um clone novo não pagam duas vezes. `--no-tm` o desativa.
`--receipt run.json`	Escreve um registro da execução: modelo, plano, idiomas entregues, caracteres cobrados e reutilizados. Apenas contagens, sem strings.

Arquivos: .json .yml .yaml .strings .xcstrings .po .arb .xml .csv .xliff .xlf .properties .resx .ftl .md .mdx. Um código de idioma desconhecido é recusado antes que qualquer coisa seja enviada: kaeris languages lista os válidos. Códigos de saída de translate: 0 concluído, 1 erro, 3 alguns idiomas voltaram sem tradução. Lista completa: kaeris translate --help.

Guias por formato: JSON · YAML · PO · XLIFF · ARB · .strings · .xcstrings · Fluent · .properties · .resx · CSV · Markdown · Android XML

CI recipes (in English): GitHub Actions · GitLab CI · pre-commit · Make and npm scripts

KAERIS traduziu esta página e verificou cada linha traduzindo-a de volta. Um falante nativo ainda não revisou. Original em inglês