Kommandozeile

Ein Python-Paket ohne Abhängigkeiten. Ohne Schlüssel läuft es als kostenlose Demo: 10.000 Zeichen pro Datei, bis zu 8 Sprachen pro Lauf.

Ausführen

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

Ausgabe, gekürzt

→ 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

Nächste Befehle

Befehl	Was er macht
`kaeris init`	Schreibt `kaeris.json` mit Ihrer Quelldatei, Sprachen und dem Ausgabeordner, sodass `kaeris translate` ohne Flags ausgeführt wird. `--preset` füllt es für i18next, react-i18next, next-intl, react-intl, vue-i18n oder flutter-arb.
`kaeris translate --only-new`	Übersetzt nur neue und bearbeitete Schlüssel. `kaeris.lock` neben der Quelle merkt sich, was getan wurde. JSON und ARB.
`kaeris check`	Findet fehlerhafte Übersetzungen auf Ihrem Rechner, ohne Schlüssel. Ohne Python: `npx kaeris check` (Node 18+). Details zur Prüfung.
`kaeris languages`	Gibt die 46 Sprachcodes aus.
`kaeris quota`	Wie viel vom Monatsvolumen Ihres Schlüssels noch übrig ist.

Wichtige Flags

Flag	Bedeutung
`--langs de,ja`	Zielsprachen, durch Kommas getrennt. Kurzform `-l`.
`--out locales`	Wohin die Dateien geschrieben werden. Standard: neben der Quelle.
`--verify`	Übersetzt jedes Ergebnis zurück ins Englische und schreibt `verify.json`, damit Sie die Bedeutung überprüfen können.
`--keep 'KAERIS,GitHub'`	Wörter, die in jeder Sprache unverändert bleiben, wie Markennamen.
`--context 'a bank app'`	Eine Zeile über Ihre App. Hilft bei Wörtern mit zwei Bedeutungen.
`--tone formal`	`neutral`, `formal` oder `casual`.
`--model openai/gpt-4.1`	Lifetime: das OpenRouter-Modell für die Übersetzung. Eines pro Sprache: `models` in `kaeris.json`. In anderen Tarifen wird die Anfrage mit Begründung abgelehnt.
`--key`	Ihr API-Schlüssel. Oder setzen Sie `KAERIS_API_KEY`, was sicherer ist: Ein nach `--key` eingegebener Schlüssel bleibt in Ihrer Shell-Historie und wird in der Prozessliste angezeigt.
`--source-lang en`	Sprache der Quelldatei. Standard `en`; erkennt auch Strukturen wie `locales/<lang>/<namespace>.json`.
`--back-lang en`	In welche Sprache `--verify` zurückübersetzt. Standard `en`.
`--lock PATH`	Wo `kaeris.lock` liegt. Standard: neben der Quelle.
`--assume-current`	Erster `--only-new`-Lauf in einem bereits übersetzten Projekt: den vorhandenen Übersetzungen vertrauen, statt alles neu zu übersetzen.
`--tm PATH`	Translation-Memory-Datei, standardmäßig `kaeris-tm.json` neben der Quelle. Sie verwendet Übersetzungen anhand des Textes wieder, sodass ein umbenannter Schlüssel oder ein frischer Klon nicht doppelt bezahlt wird. `--no-tm` schaltet sie ab.
`--receipt run.json`	Schreibt ein Protokoll des Laufs: Modell, Tarif, gelieferte Sprachen, berechnete und wiederverwendete Zeichen. Nur Zählerstände, keine Strings.

Dateien: .json .yml .yaml .strings .xcstrings .po .arb .xml .csv .xliff .xlf .properties .resx .ftl .md .mdx. Ein unbekannter Sprachcode wird abgelehnt, bevor etwas gesendet wird: kaeris languages listet die gültigen auf. Exit-Codes von translate: 0 erledigt, 1 Fehler, 3 einige Sprachen kamen unübersetzt zurück. Vollständige Liste: kaeris translate --help.

Anleitungen nach 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 hat diese Seite übersetzt und jede Zeile durch Rückübersetzung geprüft. Ein Muttersprachler hat sie noch nicht überprüft. Englisches Original