# Indic Language Translator

> Use when a user wants to translate text to or from any Indian language — Hindi, Tamil, Telugu, Bengali, Marathi, Kannada, Malayalam, Gujarati, Punjabi, Urdu, Odia, Assamese, Sanskrit — or says "translate this message", "translate this to Hindi", "what does this say in Tamil", "convert to Marathi", or similar. Also handles global languages (Spanish, French, Arabic, Chinese, Japanese, Korean, etc.). Uses Gemini 2.5 Flash. Also use when asked to detect what language a piece of text is written in.

- Skill: `rushindrasinha/indic-language-translator` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add rushindrasinha/indic-language-translator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rushindrasinha/indic-language-translator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: rushindrasinha (https://skillmd.com/u/rushindrasinha)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/rushindrasinha/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 -->