AI‑powered localization for your i18next‑style JSON files. Automate translating of single files or entire directories with ChatGPT, Gemini, Claude, or local Ollama models -- while keeping accurate translations, formatting consistent, and intact {{variables}}.

For a detailed walkthrough and advanced tips, see ADVANCED_GUIDE.md.

npm i -g i18n-ai-translate    # or yarn add i18n-ai-translate --dev
export OPENAI_API_KEY=•••     # or GEMINI_API_KEY / ANTHROPIC_API_KEY

i18n-ai-translate translate -i i18n/en.json -o fr \
  -e chatgpt -m gpt-4o

Need more languages? Pass multiple codes (-o fr es de) or -A for all 180+.

i18n-ai-translate translate -i i18n/en -o fr es de \
  -e chatgpt -m gpt-4o

This recursively translates all *.json files in en and writes to i18n/fr, i18n/es, and i18n/de.

Add a one‑liner GitHub Action to auto‑translate whenever en.json changes:

- uses: taahamahdi/i18n-ai-translate@master
  with:
    json-file-path: i18n/en.json
    api-key: ${{ secrets.OPENAI_API_KEY }}

# Translate a file or folder
translate   -i <src>      -o <lang…>   [options]

# Re‑translate only edited keys
diff        -b <before>   -a <after>   [options]

# See all flags
--help

Common flags:

Full flag list: i18n-ai-translate translate --help.

import { translate } from "i18n-ai-translate";

const fr = await translate({
  inputJSON: require("./en.json"),
  inputLanguage: "en",
  outputLanguage: "fr",
  engine: "chatgpt",
  model: "gpt-4o",
  apiKey: process.env.OPENAI_API_KEY,
});

• Prompt modes: csv (faster) vs json (maximum fidelity)
• Custom prompts: swap in your own generation / verification prompts
• Placeholders: keep {{prefix}} & {{suffix}} exactly as‑is