Línea de comandos

Un paquete Python sin dependencias. Sin clave, se ejecuta como la demo gratuita: 10.000 caracteres por archivo, hasta 8 idiomas por ejecución.

Ejecutar

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

Salida (resumida)

→ 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

Siguientes comandos

Comando	Qué hace
`kaeris init`	Escribe `kaeris.json` con tu archivo fuente, idiomas y carpeta de salida, para que `kaeris translate` se ejecute sin flags. `--preset` lo rellena para i18next, react-i18next, next-intl, react-intl, vue-i18n o flutter-arb.
`kaeris translate --only-new`	Traduce solo claves nuevas y editadas. `kaeris.lock` junto a la fuente recuerda lo que está hecho. JSON y ARB.
`kaeris check`	Encuentra traducciones rotas en tu máquina, sin clave. Sin Python: `npx kaeris check` (Node 18+). Detalles de la comprobación.
`kaeris languages`	Muestra los 46 códigos de idioma.
`kaeris quota`	Cuánto volumen de este mes le queda a tu clave.

Flags principales

Flag	Significado
`--langs de,ja`	Idiomas de destino, separados por comas. Forma corta `-l`.
`--out locales`	Dónde escribir los archivos. Por defecto: junto a la fuente.
`--verify`	Traduce cada resultado de vuelta al inglés y escribe `verify.json`, para que puedas comprobar el significado.
`--keep 'KAERIS,GitHub'`	Palabras que se quedan tal como están escritas en todos los idiomas, como nombres de marca.
`--context 'a bank app'`	Una línea sobre tu aplicación. Ayuda con palabras que tienen dos significados.
`--tone formal`	`neutral`, `formal` o `casual`.
`--model openai/gpt-4.1`	Lifetime: el modelo de OpenRouter con el que se traduce. Uno por idioma: `models` en `kaeris.json`. En otros planes la solicitud se rechaza indicando el motivo.
`--key`	Tu clave de API. O configura `KAERIS_API_KEY`, que es más seguro: una clave escrita después de `--key` permanece en el historial de tu shell y se muestra en la lista de procesos.
`--source-lang en`	Idioma del archivo fuente. Por defecto `en`; también detecta estructuras `locales/<lang>/<namespace>.json`.
`--back-lang en`	Idioma al que `--verify` traduce de vuelta. Por defecto `en`.
`--lock PATH`	Dónde está `kaeris.lock`. Por defecto: junto al archivo fuente.
`--assume-current`	Primera ejecución con `--only-new` en un proyecto que ya está traducido: confía en las traducciones existentes en lugar de traducir todo de nuevo.
`--tm PATH`	Archivo de memoria de traducción, por defecto `kaeris-tm.json` junto al archivo fuente. Reutiliza traducciones por texto, así que una clave renombrada o un clon nuevo no pagan dos veces. `--no-tm` lo desactiva.
`--receipt run.json`	Escribe un registro de la ejecución: modelo, plan, idiomas entregados, caracteres facturados y reutilizados. Solo recuentos, sin cadenas.

Archivos: .json .yml .yaml .strings .xcstrings .po .arb .xml .csv .xliff .xlf .properties .resx .ftl .md .mdx. Un código de idioma desconocido es rechazado antes de que se envíe algo: kaeris languages lista los válidos. Códigos de salida de translate: 0 hecho, 1 error, 3 algunos idiomas volvieron sin traducir. Lista completa: kaeris translate --help.

Guías por 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 traducido esta página y revisado cada línea traduciéndola de vuelta. Un hablante nativo aún no la ha revisado. Original en inglés