コマンドライン
依存関係のないPythonパッケージです。キーなしでは無料デモとして実行されます（ファイルあたり10,000文字、実行あたり最大8言語）。
実行
pip install kaeris kaeris translate en.json --langs de,ja
出力（短縮版）
→ 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
次のコマンド
| コマンド | 機能 |
|---|---|
kaeris init | ソースファイル、言語、出力フォルダを含むkaeris.jsonを書き込みます。これにより、kaeris translateはフラグなしで実行できます。--presetは、i18next、react-i18next、next-intl、react-intl、vue-i18n、またはflutter-arb用にこれを埋めます。 |
kaeris translate --only-new | 新規および編集されたキーのみを翻訳します。ソースの隣にあるkaeris.lockは、完了したことを記憶します。JSONおよびARB。 |
kaeris check | ローカルマシン上の壊れた翻訳を見つけます。キー不要。Python なしなら npx kaeris check（Node 18 以上）。チェックの詳細。 |
kaeris languages | 46の言語コードを表示します。 |
kaeris quota | 今月の使用量のうち、キーに残っている量を示します。 |
主なフラグ
| フラグ | 意味 |
|---|---|
--langs de,ja | ターゲット言語（カンマ区切り）。短縮形-l。 |
--out locales | ファイルを書き込む場所。デフォルト：ソースの隣。 |
--verify | すべての結果を英語に逆翻訳し、verify.jsonを書き込みます。これにより、意味を確認できます。 |
--keep 'KAERIS,GitHub' | ブランド名など、すべての言語でそのまま記述される単語。 |
--context 'a bank app' | アプリに関する1行の説明。意味が2つある単語に役立ちます。 |
--tone formal | neutral、formal、またはcasual。 |
--model openai/gpt-4.1 | Lifetime：翻訳に使う OpenRouter のモデル。言語ごとに指定するには kaeris.json の models。他のプランでは理由を示して拒否されます。 |
--key | APIキー。またはKAERIS_API_KEYを設定します。こちらの方が安全です。--keyの後にタイプされたキーは、シェル履歴に残り、プロセスリストに表示されます。 |
--source-lang en | ソースファイルの言語。デフォルトen。locales/<lang>/<namespace>.jsonレイアウトも見つけます。 |
--back-lang en | --verifyが逆翻訳する言語。デフォルトen。 |
--lock PATH | kaeris.lock が存在する場所。デフォルトはソースの隣です。 |
--assume-current | すでに翻訳済みのプロジェクトに対する最初の --only-new 実行: すでにある翻訳を信頼し、すべてを再翻訳しません。 |
--tm PATH | 翻訳メモリファイル。デフォルトでソースの隣にある kaeris-tm.json。テキスト単位で翻訳を再利用するため、キーの名前変更や新しいクローンで二重課金されません。--no-tm で無効化します。 |
--receipt run.json | 実行の記録を書き込みます：モデル、プラン、提供した言語、課金された文字数と再利用された文字数。数値のみで、文字列は含みません。 |
対応ファイル: .json .yml .yaml .strings .xcstrings .po .arb .xml .csv .xliff .xlf .properties .resx .ftl .md .mdx。不明な言語コードは何かを送信する前に拒否されます。有効なコードは kaeris languages で確認できます。translate の終了コード: 0 完了、1 エラー、3 一部の言語が未翻訳のまま返された。全リストは kaeris translate --help。
形式別ガイド: 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はこのページを翻訳し、すべての行を逆翻訳して確認しました。ネイティブスピーカーによるレビューはまだ行われていません。 英語原文