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

1. Visit Google AI Studio
2. Sign in with your Google account
3. 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

• 📖 Documentation
• 🐛 Report Issues
• 💬 Discussions
• ⭐ Star the Project

🗺️ 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