linguAIsync

AI-powered translation synchronization tool. Automatically detects missing translations and uses OpenAI to translate them while preserving formatting and placeholders.

Installation

npm install linguaisync

Quick Start

1. Set OpenAI API key

export OPENAI_API_KEY="sk-your-api-key"

2. Create linguaisync.config.js

const path = require('path');

module.exports = {
  localesDir: path.join(__dirname, 'public/locales'),
  baseLanguage: 'en',
  translationFiles: ['translation.json'],
};

3. Directory structure

locales/
├── en/
│   └── translation.json
└── es/
    └── translation.json

4. Run

# Preview changes
npx linguaisync --all --dry-run

# Sync all languages
npx linguaisync --all

# Sync specific languages
npx linguaisync --lang es,fr,de

CLI Options

linguaisync --all                      # Process all languages
linguaisync --lang es,fr               # Process specific languages
linguaisync --all --dry-run            # Preview without changes
linguaisync --all --dry-run --verbose  # Show detailed output
linguaisync --all --dry-run --output missing.json  # Export to file
linguaisync --config custom.js         # Use custom config
linguaisync --locales-dir ./i18n       # Override locales path

Configuration

JavaScript config (linguaisync.config.js):

const path = require('path');

module.exports = {
  localesDir: path.join(__dirname, 'public/locales'),
  baseLanguage: 'en',
  translationFiles: ['translation.json', 'common.json'],
  batchSize: 20,
  model: 'gpt-4o-mini',
  temperature: 0.3,
};

JSON config (linguaisync.config.json):

{
  "localesDir": "./public/locales",
  "baseLanguage": "en",
  "translationFiles": ["translation.json"],
  "batchSize": 20
}

Programmatic API

const { createConfig, syncLanguages, analyzeLanguages } = require('linguaisync');

const config = createConfig({
  localesDir: './locales',
  baseLanguage: 'en',
});

// Analyze (dry run)
const missing = analyzeLanguages(config, ['es', 'fr'], true);

// Sync translations
await syncLanguages(config, ['es', 'fr']);

Supported Languages

Language	Code	Language	Code	Language	Code
Arabic	ar	German	de	Japanese	jp
Bulgarian	bg	Greek	el	Korean	ko
Chinese	zh	Indonesian	id	Dutch	nl
Danish	da	Italian	it	Norwegian	no
Spanish	es	Polish	pl	Ukrainian	ua
Finnish	fi	Portuguese	pt	Vietnamese	vi
French	fr	Romanian	ro
		Russian	ru
		Slovenian	sl
		Swedish	sv
		Turkish	tr

NPM Scripts

Add to package.json:

{
  "scripts": {
    "i18n:check": "linguaisync --all --dry-run --verbose",
    "i18n:sync": "linguaisync --all"
  }
}

Features

• 🤖 AI-powered translations via OpenAI
• 🔄 Automatic missing key detection
• 🎯 Smart batching for API efficiency
• 📦 Multi-file support
• 🔑 Preserves placeholders ({{var}}) and HTML
• 🧪 Dry run mode
• 💾 Export to JSON

License

This project is licensed under the MIT License.

🌟 Please check my other projects!

• tududi - Productivity made simple
• Reconya - Network reconnaissance and asset discovery tool
• BreachHarbor - Cybersecurity suite for digital asset protection
• Hevetra - Digital tracking for child health milestones

---

README created by Chris Veleris for linguAIsync.