{"id":32293666,"url":"https://github.com/fuzail-git/ai_translation_generator","last_synced_at":"2026-05-17T15:04:58.535Z","repository":{"id":317728213,"uuid":"1068633048","full_name":"FUZAIL-GIT/ai_translation_generator","owner":"FUZAIL-GIT","description":"Professional CLI tool for AI-powered translation generation using Google's Gemini AI. Generate Flutter l10n files with ease and support for 100+ languages.","archived":false,"fork":false,"pushed_at":"2025-10-02T18:10:53.000Z","size":32,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"dev","last_synced_at":"2026-05-13T02:47:33.588Z","etag":null,"topics":["ai","artificial-intelligence","auto","automation","cli","clitool","dart","dart-package","flutter","gemini","generator","il8n","internationalization","l10n","localized","open-source","pub","tools","translation"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FUZAIL-GIT.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-02T17:14:02.000Z","updated_at":"2025-10-02T18:10:57.000Z","dependencies_parsed_at":"2025-10-08T20:02:42.814Z","dependency_job_id":null,"html_url":"https://github.com/FUZAIL-GIT/ai_translation_generator","commit_stats":null,"previous_names":["fuzail-git/ai_translation_generator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/FUZAIL-GIT/ai_translation_generator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FUZAIL-GIT%2Fai_translation_generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FUZAIL-GIT%2Fai_translation_generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FUZAIL-GIT%2Fai_translation_generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FUZAIL-GIT%2Fai_translation_generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FUZAIL-GIT","download_url":"https://codeload.github.com/FUZAIL-GIT/ai_translation_generator/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FUZAIL-GIT%2Fai_translation_generator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33143276,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-17T09:28:26.183Z","status":"ssl_error","status_checked_at":"2026-05-17T09:27:52.702Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","artificial-intelligence","auto","automation","cli","clitool","dart","dart-package","flutter","gemini","generator","il8n","internationalization","l10n","localized","open-source","pub","tools","translation"],"created_at":"2025-10-23T03:35:04.067Z","updated_at":"2026-05-17T15:04:58.530Z","avatar_url":"https://github.com/FUZAIL-GIT.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AI Translation Generator\n\n[![pub package](https://img.shields.io/pub/v/ai_translation_generator.svg)](https://pub.dev/packages/ai_translation_generator)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nA professional CLI tool for AI-powered translation generation using Google's Gemini AI. Generate Flutter l10n files with ease and support for multiple languages.\n\n## ✨ Features\n\n- 🚀 **Easy Setup**: Initialize with a single command\n- 🌍 **Multi-language Support**: Translate to multiple languages simultaneously\n- 🎨 **Professional CLI**: Beautiful terminal interface with progress indicators\n- 🔧 **Flutter l10n Standard**: Generates files in `lib/l10n/` directory\n- 🌐 **Internet Connectivity**: Automatic connection checking and error handling\n- ⚡ **Fast \u0026 Efficient**: Optimized for speed with parallel processing\n- 🔐 **Secure**: No hardcoded API keys, users provide their own\n\n## 📦 Installation\n\n### Prerequisites\n\n- [Dart SDK](https://dart.dev/get-dart) version 3.8.1 or higher\n\n### Global Installation\n\n```bash\ndart pub global activate ai_translation_generator\n```\n\n### Local Development\n\n```bash\ngit clone https://github.com/FUZAIL-GIT/ai_translation_generator.git\ncd ai_translation_generator\ndart pub get\ndart compile exe bin/ai_translation_generator.dart -o aitranslation\n```\n\n## 🔑 API Key Setup\n\n### Get Your Free Gemini API Key\n\n1. Visit [Google AI Studio](https://makersuite.google.com/app/apikey)\n2. Sign in with your Google account\n3. Generate a free API key (no credit card required)\n\n### Configure Your API Key\n\n**Option A: Environment Variable (Recommended)**\n\n```bash\nexport GEMINI_API_KEY=your_gemini_api_key_here\n```\n\n**Option B: .env File**\n\n```bash\n# Create .env file in your project root\necho \"GEMINI_API_KEY=your_gemini_api_key_here\" \u003e .env\n```\n\n## 🚀 Quick Start\n\n### 1. Initialize Configuration\n\n```bash\naitranslation init\n```\n\nThis creates a `ai_translation_generator.yaml` file:\n\n```yaml\n# AI Translation Generator Configuration\n# Generated by aitranslation init\n\nlanguages:\n  - en\n  - ar\n\nstrings:\n  - settings\n  - home\n  - profile\n  - logout\n```\n\n### 2. Customize Your Configuration\n\nEdit `ai_translation_generator.yaml` to add your strings and target languages:\n\n```yaml\nlanguages:\n  - en\n  - ar\n  - es\n  - fr\n  - de\n  - ja\n  - ko\n\nstrings:\n  - settings\n  - home\n  - profile\n  - logout\n  - login\n  - register\n  - dashboard\n  - notifications\n  - search\n  - filter\n```\n\n### 3. Generate Translations\n\n```bash\naitranslation generate\n```\n\n### 4. Use in Your Flutter App\n\nThe tool generates Flutter l10n compatible files:\n\n```\nlib/l10n/\n├── en.json\n├── ar.json\n├── es.json\n├── fr.json\n└── de.json\n```\n\n## 📁 Output Format\n\n### Generated Files\n\n**lib/l10n/ar.json:**\n\n```json\n{\n  \"settings\": \"إعدادات\",\n  \"home\": \"الرئيسية\",\n  \"profile\": \"الملف الشخصي\",\n  \"logout\": \"تسجيل الخروج\"\n}\n```\n\n**lib/l10n/es.json:**\n\n```json\n{\n  \"settings\": \"configuración\",\n  \"home\": \"inicio\",\n  \"profile\": \"perfil\",\n  \"logout\": \"cerrar sesión\"\n}\n```\n\n## 🔐 Security \u0026 Privacy\n\n- ✅ **No hardcoded API keys** - The package doesn't contain any API keys\n- ✅ **User-specific keys** - Each user provides their own free Gemini API key\n- ✅ **Secure storage** - Keys are stored in environment variables or .env files\n- ✅ **Local processing** - API keys never leave your machine\n- ✅ **Open source** - Full transparency in the codebase\n\n## 🛠️ Commands\n\n### Initialize\n\n```bash\naitranslation init\n```\n\nCreates the default configuration file.\n\n### Generate Translations\n\n```bash\naitranslation generate\n```\n\nGenerates translations for all configured languages.\n\n### Help\n\n```bash\naitranslation --help\n```\n\nShows available commands and usage information.\n\n## 🏗️ Architecture\n\n```\nlib/\n├── models/\n│   └── translation_config.dart    # Configuration model\n├── services/\n│   ├── config_service.dart        # Configuration management\n│   ├── gemini_service.dart        # Gemini API integration\n│   └── translation_service.dart   # Translation orchestration\n├── commands/\n│   ├── init_command.dart         # Init command\n│   └── generate_command.dart      # Generate command\n└── utils/\n    └── cli_utils.dart             # CLI utilities and formatting\n```\n\n## 📋 Configuration\n\n### Language Codes\n\nUse standard ISO 639-1 language codes:\n\n- `en` - English\n- `ar` - Arabic\n- `es` - Spanish\n- `fr` - French\n- `de` - German\n- `ja` - Japanese\n- `ko` - Korean\n- `zh` - Chinese\n- `pt` - Portuguese\n- `ru` - Russian\n\n### Supported Languages\n\nThe tool supports 100+ languages through Google's Gemini AI. See the [full list](https://cloud.google.com/translate/docs/languages) for all supported language codes.\n\n## 🚨 Error Handling\n\nThe tool includes comprehensive error handling:\n\n- ✅ **Internet connectivity checks**\n- ✅ **Configuration validation**\n- ✅ **API error handling**\n- ✅ **File system error handling**\n- ✅ **Clear error messages with suggestions**\n\n### Common Issues\n\n**API Key Not Found:**\n\n```\nGEMINI_API_KEY not found. Please set it using one of these methods:\n1. Environment variable: export GEMINI_API_KEY=your_api_key_here\n2. .env file: Create .env file in project root with GEMINI_API_KEY=your_api_key_here\n```\n\n**No Internet Connection:**\n\n```\nNo internet connection. Please check your network and try again.\n```\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n### Development Setup\n\n```bash\ngit clone https://github.com/FUZAIL-GIT/ai_translation_generator.git\ncd ai_translation_generator\ndart pub get\ndart test\n```\n\n### Running Tests\n\n```bash\ndart test\n```\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- [Google Gemini AI](https://ai.google.dev/) for providing the translation API\n- [Flutter l10n](https://docs.flutter.dev/development/accessibility-and-localization/internationalization) for the localization standard\n- The Dart community for excellent tooling and packages\n\n## 📞 Support\n\n- 📖 [Documentation](https://github.com/FUZAIL-GIT/ai_translation_generator#readme)\n- 🐛 [Report Issues](https://github.com/FUZAIL-GIT/ai_translation_generator/issues)\n- 💬 [Discussions](https://github.com/FUZAIL-GIT/ai_translation_generator/discussions)\n- ⭐ [Star the Project](https://github.com/FUZAIL-GIT/ai_translation_generator)\n\n## 🗺️ Roadmap\n\n- [ ] Support for more AI models (OpenAI, Claude)\n- [ ] Batch processing optimization\n- [ ] Custom prompt templates\n- [ ] Translation quality scoring\n- [ ] Integration with popular Flutter packages\n- [ ] VS Code extension\n- [ ] Web interface\n\n---\n\nMade with ❤️ for the Flutter community\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffuzail-git%2Fai_translation_generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffuzail-git%2Fai_translation_generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffuzail-git%2Fai_translation_generator/lists"}