Командний рядок

Пакет 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'`	Один рядок про ваш застосунок. Допомагає зі словами, що мають два значення.
`--tone formal`	`neutral`, `formal` або `casual`.
`--model openai/gpt-4.1`	Lifetime: модель OpenRouter для перекладу. Окрема для кожної мови — `models` у `kaeris.json`. На інших тарифах запит відхиляється з поясненням.
`--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 переклав цю сторінку та перевірив кожен рядок зворотним перекладом. Носій мови ще не переглядав її. Оригінал англійською