AI Translation Generator #

A professional CLI tool for AI-powered translation generation using Google's Gemini AI. Generate Flutter l10n files with ease and support for multiple languages.

✨ Features #

🚀 Easy Setup: Initialize with a single command
🌍 Multi-language Support: Translate to multiple languages simultaneously
🎨 Professional CLI: Beautiful terminal interface with progress indicators
🔧 Flutter l10n Standard: Generates files in lib/l10n/ directory
🌐 Internet Connectivity: Automatic connection checking and error handling
⚡ Fast & Efficient: Optimized for speed with parallel processing
🔐 Secure: No hardcoded API keys, users provide their own

📦 Installation #

Prerequisites #

Dart SDK version 3.8.1 or higher

Global Installation #

dart pub global activate ai_translation_generator

Local Development #

git clone https://github.com/FUZAIL-GIT/ai_translation_generator.git
cd ai_translation_generator
dart pub get
dart compile exe bin/ai_translation_generator.dart -o aitranslation

🔑 API Key Setup #

Get Your Free Gemini API Key #

Visit Google AI Studio
Sign in with your Google account
Generate a free API key (no credit card required)

Configure Your API Key #

Option A: Environment Variable (Recommended)

export GEMINI_API_KEY=your_gemini_api_key_here

Option B: .env File

# Create .env file in your project root
echo "GEMINI_API_KEY=your_gemini_api_key_here" > .env

🚀 Quick Start #

1. Initialize Configuration #

aitranslation init

This creates a ai_translation_generator.yaml file:

# AI Translation Generator Configuration
# Generated by aitranslation init

languages:
  - en
  - ar

strings:
  - settings
  - home
  - profile
  - logout

2. Customize Your Configuration #

Edit ai_translation_generator.yaml to add your strings and target languages:

languages:
  - en
  - ar
  - es
  - fr
  - de
  - ja
  - ko

strings:
  - settings
  - home
  - profile
  - logout
  - login
  - register
  - dashboard
  - notifications
  - search
  - filter

3. Generate Translations #

aitranslation generate

4. Use in Your Flutter App #

The tool generates Flutter l10n compatible files:

lib/l10n/
├── en.json
├── ar.json
├── es.json
├── fr.json
└── de.json

📁 Output Format #

Generated Files #

lib/l10n/ar.json:

{
  "settings": "إعدادات",
  "home": "الرئيسية",
  "profile": "الملف الشخصي",
  "logout": "تسجيل الخروج"
}

lib/l10n/es.json:

{
  "settings": "configuración",
  "home": "inicio",
  "profile": "perfil",
  "logout": "cerrar sesión"
}

🔐 Security & Privacy #

✅ No hardcoded API keys - The package doesn't contain any API keys
✅ User-specific keys - Each user provides their own free Gemini API key
✅ Secure storage - Keys are stored in environment variables or .env files
✅ Local processing - API keys never leave your machine
✅ Open source - Full transparency in the codebase

🛠️ Commands #

Initialize #

aitranslation init

Creates the default configuration file.

Generate Translations #

aitranslation generate

Generates translations for all configured languages.

Help #

aitranslation --help

Shows available commands and usage information.

🏗️ Architecture #

lib/
├── models/
│   └── translation_config.dart    # Configuration model
├── services/
│   ├── config_service.dart        # Configuration management
│   ├── gemini_service.dart        # Gemini API integration
│   └── translation_service.dart   # Translation orchestration
├── commands/
│   ├── init_command.dart         # Init command
│   └── generate_command.dart      # Generate command
└── utils/
    └── cli_utils.dart             # CLI utilities and formatting

📋 Configuration #

Language Codes #

Use standard ISO 639-1 language codes:

en - English
ar - Arabic
es - Spanish
fr - French
de - German
ja - Japanese
ko - Korean
zh - Chinese
pt - Portuguese
ru - Russian

Supported Languages #

The tool supports 100+ languages through Google's Gemini AI. See the full list for all supported language codes.

🚨 Error Handling #

The tool includes comprehensive error handling:

✅ Internet connectivity checks
✅ Configuration validation
✅ API error handling
✅ File system error handling
✅ Clear error messages with suggestions

Common Issues #

API Key Not Found:

GEMINI_API_KEY not found. Please set it using one of these methods:
1. Environment variable: export GEMINI_API_KEY=your_api_key_here
2. .env file: Create .env file in project root with GEMINI_API_KEY=your_api_key_here

No Internet Connection:

No internet connection. Please check your network and try again.

🤝 Contributing #

We welcome contributions! Please see our Contributing Guide for details.

Development Setup #

git clone https://github.com/FUZAIL-GIT/ai_translation_generator.git
cd ai_translation_generator
dart pub get
dart test

Running Tests #

dart test

📄 License #

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments #

Google Gemini AI for providing the translation API
Flutter l10n for the localization standard
The Dart community for excellent tooling and packages

📞 Support #

🗺️ Roadmap #

❌ Support for more AI models (OpenAI, Claude)
❌ Batch processing optimization
❌ Custom prompt templates
❌ Translation quality scoring
❌ Integration with popular Flutter packages
❌ VS Code extension
❌ Web interface

Made with ❤️ for the Flutter community

ai_translation_generator 1.0.2 ai_translation_generator: ^1.0.2 copied to clipboard

Metadata