An AI-powered internationalization tool that automatically translates JSON locale files using OpenAI's GPT-4 model. Localiser supports batch translation across multiple languages and namespaces with a simple CLI interface.

• 🤖 AI-Powered Translation: Uses OpenAI's GPT-4 for high-quality translations
• 📁 Namespace Management: Organize translations by namespaces (e.g., home, settings, common)
• 📊 Real-time Progress: Visual progress bars showing translation status
• ⚡ CLI Interface: Simple command-line interface for easy integration
• 🔧 Configurable: Flexible configuration through JSON files

• 🗂️ Dynamic folder structure support: Now supports lang/namespace.json, lang.json is not supported yet
• 💿 Optimized translation: Translate only missing keys in the target language files (add a flag to override existing translations)
• 🤖 AI Model selection: Allow users to choose between different OpenAI models (e.g., GPT-3.5, GPT-4)
• 🎬 Init command: Add a command to initialize the project with default configuration json file

Feel free to contribute to the project by submitting issues or pull requests!

• Node.js (v16 or higher)
• OpenAI API key (Add this to .env file of your project)

npm install -g @pulimoodan/localiser

Create a .env file in your project root:

OPENAI_API_KEY=your_openai_api_key_here

Create a localiser.json file to configure your translation settings:

{
  "directory": "public/locales",
  "sourceLanguage": "en",
  "languages": ["fr", "es", "de", "it", "pt", "zh", "ja", "ru"],
  "namespaces": ["home", "settings"]
}

• directory: Path to your locales directory
• sourceLanguage: Source language code (e.g., "en")
• languages: Array of target language codes to translate to
• namespaces: Array of namespace names to translate

Translate all configured languages and namespaces:

loaliser

loaliser --language fr,es

loaliser --namespace home,settings

loaliser --language fr --namespace home

localiser --config custom-config.json

• commander: CLI argument parsing
• dotenv: Environment variable management
• fs-extra: Enhanced file system operations
• openai: OpenAI API client

ISC License

pulimoodan

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

For issues and questions, please open an issue on the GitHub repository.