Ligne de commande

Un paquet Python sans dépendances. Sans clé, il fonctionne comme la démo gratuite : 10 000 caractères par fichier, jusqu'à 8 langues par exécution.

Exécuter

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

Sortie (abrégée)

→ 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

Commandes suivantes

Commande	Rôle
`kaeris init`	Écrit `kaeris.json` avec votre fichier source, vos langues et votre dossier de sortie, pour que `kaeris translate` s'exécute sans options. `--preset` le remplit pour i18next, react-i18next, next-intl, react-intl, vue-i18n ou flutter-arb.
`kaeris translate --only-new`	Traduit uniquement les clés nouvelles et modifiées. `kaeris.lock` à côté de la source se souvient de ce qui a été fait. JSON et ARB.
`kaeris check`	Trouve les traductions cassées sur votre machine, sans clé. Sans Python : `npx kaeris check` (Node 18+). Détails de la vérification.
`kaeris languages`	Affiche les 46 codes de langue.
`kaeris quota`	Le volume restant ce mois-ci sur votre clé.

Options principales

Option	Signification
`--langs de,ja`	Langues cibles, séparées par des virgules. Forme courte `-l`.
`--out locales`	Où écrire les fichiers. Par défaut : à côté de la source.
`--verify`	Retraduit chaque résultat en anglais et écrit `verify.json`, pour que vous puissiez vérifier le sens.
`--keep 'KAERIS,GitHub'`	Mots qui restent tels quels dans toutes les langues, tels que les noms de marque.
`--context 'a bank app'`	Une ligne sur votre application. Aide pour les mots qui ont deux sens.
`--tone formal`	`neutral`, `formal` ou `casual`.
`--model openai/gpt-4.1`	Lifetime : le modèle OpenRouter utilisé pour traduire. Un par langue : `models` dans `kaeris.json`. Sur les autres offres, la requête est refusée avec la raison.
`--key`	Votre clé API. Ou définissez `KAERIS_API_KEY`, ce qui est plus sûr : une clé tapée après `--key` reste dans l'historique de votre shell et s'affiche dans la liste des processus.
`--source-lang en`	Langue du fichier source. Par défaut `en` ; reconnaît aussi les arborescences `locales/<lang>/<namespace>.json`.
`--back-lang en`	Langue vers laquelle `--verify` retraduit. Par défaut `en`.
`--lock PATH`	Emplacement de `kaeris.lock`. Par défaut : à côté de la source.
`--assume-current`	Première exécution de `--only-new` sur un projet déjà traduit : faire confiance aux traductions existantes au lieu de tout retraduire.
`--tm PATH`	Fichier de mémoire de traduction, par défaut `kaeris-tm.json` à côté de la source. Il réutilise les traductions d'après le texte : une clé renommée ou un nouveau clone ne paie pas deux fois. `--no-tm` le désactive.
`--receipt run.json`	Écrit un relevé de l'exécution : modèle, offre, langues livrées, caractères facturés et réutilisés. Uniquement des compteurs, aucune chaîne.

Fichiers : .json .yml .yaml .strings .xcstrings .po .arb .xml .csv .xliff .xlf .properties .resx .ftl .md .mdx. Un code de langue inconnu est refusé avant l'envoi de quoi que ce soit : kaeris languages liste les codes valides. Codes de sortie de translate : 0 terminé, 1 erreur, 3 certaines langues sont revenues non traduites. Liste complète : kaeris translate --help.

Guides par format: 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 a traduit cette page et vérifié chaque ligne en la retraduisant. Un locuteur natif ne l'a pas encore revue. Original anglais