Riga di comando

Un pacchetto Python senza dipendenze. Senza chiave funziona come demo gratuita: 10.000 caratteri per file, fino a 8 lingue per esecuzione.

Esegui

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

Output (abbreviato)

→ 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

Comandi successivi

Comando	Cosa fa
`kaeris init`	Scrive `kaeris.json` con il tuo file sorgente, le lingue e la cartella di output, in modo che `kaeris translate` venga eseguito senza flag. `--preset` lo compila per i18next, react-i18next, next-intl, react-intl, vue-i18n o flutter-arb.
`kaeris translate --only-new`	Traduce solo le chiavi nuove e modificate. `kaeris.lock` accanto al sorgente ricorda cosa è stato fatto. JSON e ARB.
`kaeris check`	Trova le traduzioni difettose sulla tua macchina, senza chiave. Senza Python: `npx kaeris check` (Node 18+). Dettagli del controllo.
`kaeris languages`	Stampa i 46 codici lingua.
`kaeris quota`	Quanto del volume di questo mese è rimasto sulla tua chiave.

Flag principali

Flag	Significato
`--langs de,ja`	Lingue di destinazione, separate da virgola. Forma breve `-l`.
`--out locales`	Dove scrivere i file. Predefinito: accanto al sorgente.
`--verify`	Ritraduce ogni risultato in inglese e scrive `verify.json`, così puoi controllare il significato.
`--keep 'KAERIS,GitHub'`	Parole che restano come sono in ogni lingua, per esempio i nomi dei marchi.
`--context 'a bank app'`	Una riga sulla tua app. Aiuta con parole che hanno due significati.
`--tone formal`	`neutral`, `formal` o `casual`.
`--model openai/gpt-4.1`	Lifetime: il modello OpenRouter con cui tradurre. Uno per lingua: `models` in `kaeris.json`. Negli altri piani la richiesta viene rifiutata con il motivo.
`--key`	La tua chiave API. Oppure imposta `KAERIS_API_KEY`, che è più sicuro: una chiave digitata dopo `--key` rimane nella cronologia della shell e viene visualizzata nell'elenco dei processi.
`--source-lang en`	Lingua del file sorgente. Predefinito `en`; riconosce anche strutture `locales/<lang>/<namespace>.json`.
`--back-lang en`	Lingua in cui `--verify` ritraduce. Predefinito `en`.
`--lock PATH`	Dove si trova `kaeris.lock`. Predefinito: accanto al sorgente.
`--assume-current`	Prima esecuzione di `--only-new` su un progetto già tradotto: considera valide le traduzioni esistenti invece di ritradurre tutto.
`--tm PATH`	File di memoria di traduzione, per impostazione predefinita `kaeris-tm.json` accanto al sorgente. Riutilizza le traduzioni in base al testo, così una chiave rinominata o un nuovo clone non pagano due volte. `--no-tm` lo disattiva.
`--receipt run.json`	Scrive un registro dell'esecuzione: modello, piano, lingue consegnate, caratteri addebitati e riutilizzati. Solo conteggi, nessuna stringa.

File: .json .yml .yaml .strings .xcstrings .po .arb .xml .csv .xliff .xlf .properties .resx .ftl .md .mdx. Un codice lingua sconosciuto viene rifiutato prima che venga inviato qualcosa: kaeris languages elenca quelli validi. Codici di uscita di translate: 0 completato, 1 errore, 3 alcune lingue sono tornate non tradotte. Elenco completo: kaeris translate --help.

Guide per 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 ha tradotto questa pagina e controllato ogni riga ritraducendola. Un madrelingua non l'ha ancora revisionata. Originale in inglese