rushindrasinha/ares-skills/indic-language-translator

Indic Language Translator

Overview

High-quality translation to/from Indian and global languages using Gemini 2.5 Flash. Supports 13 Indian languages and 10 global languages. Also detects language from input text.

Usage

Translate text:

python3 scripts/translate.py "Your order is confirmed" --to hi
python3 scripts/translate.py "आपका ऑर्डर कन्फर्म हो गया" --to en
python3 scripts/translate.py "Hello" --to ta --from en

Detect language:

python3 scripts/translate.py "नमस्ते" --detect

List supported languages:

python3 scripts/translate.py --list

JSON output:

python3 scripts/translate.py "Hello" --to hi --json

Pipe stdin:

echo "Hello world" | python3 scripts/translate.py --to mr

Workflow

1. Receive text and target language from user request
2. Map language name to ISO code if needed (e.g. "Hindi" → hi, "Tamil" → ta)
3. Run scripts/translate.py "<text>" --to <code>
4. Script calls Gemini 2.5 Flash with zero temperature (deterministic output)
5. Returns only the translated text — no labels, quotes, or explanations
6. For batch translation, use translate_batch() as a module to translate multiple strings in one API call

Supported Language Codes

Indian: hi Hindi, ta Tamil, te Telugu, mr Marathi, bn Bengali, gu Gujarati, kn Kannada, ml Malayalam, pa Punjabi, ur Urdu, or Odia, as Assamese, sa Sanskrit

Global: en English, es Spanish, fr French, de German, pt Portuguese, ar Arabic, zh Chinese, ja Japanese, ko Korean, ru Russian, id Indonesian

Scripts

• scripts/translate.py — CLI and importable module. Functions: translate(text, to_lang, from_lang), detect_language(text), translate_batch(texts, to_lang). Uses Gemini API directly via urllib (no extra dependencies).

Requirements

• Gemini API key (embedded; also reads GEMINI_API_KEY or GOOGLE_API_KEY env vars)
• Python 3.10+ (uses list[str] type hints)
• Internet connection

<!-- A·R·E·S 🛡️ | Mumbai | 2026-04-05 | github.com/rushindrasinha -->