Instructions to use udgamlabs/Paar-en-ta with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use udgamlabs/Paar-en-ta with Transformers:
# Use a pipeline as a high-level helper # Warning: Pipeline type "translation" is no longer supported in transformers v5. # You must load the model directly (see below) or downgrade to v4.x with: # pip install "transformers<5.0.0" from transformers import pipeline pipe = pipeline("translation", model="udgamlabs/Paar-en-ta")# pip install -U transformers accelerate # Load model directly from transformers import AutoTokenizer, AutoModelForSeq2SeqLM tokenizer = AutoTokenizer.from_pretrained("udgamlabs/Paar-en-ta") model = AutoModelForSeq2SeqLM.from_pretrained("udgamlabs/Paar-en-ta", device_map="auto") - Transformers.js
How to use udgamlabs/Paar-en-ta with Transformers.js:
// npm i @huggingface/transformers import { pipeline } from '@huggingface/transformers'; // Allocate pipeline const pipe = await pipeline('translation', 'udgamlabs/Paar-en-ta'); - Notebooks
- Google Colab
- Kaggle
UDGAM LABS · Translator · English → Tamil · 17.3M parameters, 17.7 MB at int8
Paar English → Tamil
Paar English → Tamil translates English sentences into Tamil (Tamil). It has 17.3M parameters: the int8 model file is 17.7 MB (20.0 MB with its vocabulary), and it runs offline on an ordinary CPU, about 30 ms a sentence on one core of a Mac mini, or in a web browser with transformers.js. It was distilled from IndicTrans2: it learned from English sentences that IndicTrans2 dist-200M translated. Against Firefox's offline English-to-Tamil model (31.6 MB, about 1.6 times its size), it is behind by 2.81 chrF++ on FLORES+ (news-style text) and behind by 0.98 on IN22-Conv (everyday conversation). Against indicMT, a model about 8.5 times larger to download, it is level (no measurable difference) on FLORES+ and behind by 2.02 on IN22-Conv. All differences are paired, with 95% intervals (Results below).
It is one of twelve, English to: Hindi, Bengali, Marathi, Telugu, Tamil, Gujarati, Urdu, Kannada, Malayalam, Punjabi, Odia, Assamese.
Try it: in your browser · code and fine-tuning recipe on GitHub
Quick start
Transformers (the weights as trained):
# pip install transformers sentencepiece torch
from transformers import MarianMTModel, MarianTokenizer
repo = "udgamlabs/Paar-en-ta"
tok = MarianTokenizer.from_pretrained(repo)
model = MarianMTModel.from_pretrained(repo)
batch = tok(["Can you send me the invoice for the last three months?"], return_tensors="pt", padding=True, truncation=True, max_length=128)
out = model.generate(**batch, num_beams=1, max_new_tokens=200)
print(tok.batch_decode(out, skip_special_tokens=True)[0])
# கடந்த மூன்று மாதங்களுக்கு நீங்கள் எனக்கு விலைப்பட்டியல் அனுப்ப முடியுமா?
CTranslate2 int8 (the small, fast build in ct2-int8/):
# pip install ctranslate2 sentencepiece huggingface_hub
import ctranslate2, sentencepiece as spm
from huggingface_hub import snapshot_download
path = snapshot_download("udgamlabs/Paar-en-ta", allow_patterns=["config.json", "ct2-int8/*"])
sp = spm.SentencePieceProcessor(model_file=f"{path}/ct2-int8/source.spm")
tr = ctranslate2.Translator(f"{path}/ct2-int8", device="cpu", compute_type="int8")
def translate(sentences):
pieces = [p[:127] + ["</s>"] for p in sp.encode(sentences, out_type=str)]
out = tr.translate_batch(pieces, beam_size=1, max_decoding_length=200)
return [sp.decode([t for t in r.hypotheses[0] if t != "</s>"]) for r in out]
print(translate(["Can you send me the invoice for the last three months?"])[0])
JavaScript, in the browser or Node, with transformers.js (the ONNX build in onnx/, int8):
// npm install @huggingface/transformers
import { pipeline } from "@huggingface/transformers";
const translate = await pipeline("translation", "udgamlabs/Paar-en-ta", { dtype: "q8" });
const [out] = await translate("Can you send me the invoice for the last three months?", { max_new_tokens: 200 });
console.log(out.translation_text);
// கடந்த மூன்று மாதங்களுக்கு நீங்கள் எனக்கு விலைப்பட்டியல் அனுப்ப முடியுமா?
- One sentence per input. Split paragraphs into sentences first; inputs are cut at 127 pieces.
- Greedy decoding (
num_beams=1) is what we scored. Beam search was not tested. - The CTranslate2 int8 build scores 0.07 chrF++ from the fp32 weights on FLORES+, and 75% of its translations are word for word the same. The ONNX int8 build (for transformers.js) is within 0.02 chrF++ of the fp32 weights on both test sets. In the browser, the int8 files are 28.9 MB, downloaded once.
| English | Paar English → Tamil (from the Transformers quick start) |
|---|---|
| The train leaves at 6:45 tomorrow morning, so please be at the station by 6:15. | ரயில் நாளை காலை 6.45 மணிக்கு செல்கிறது, எனவே தயவுசெய்து 6:15 க்குள் நிலையத்தில் இருங்கள். |
| Can you send me the invoice for the last three months? | கடந்த மூன்று மாதங்களுக்கு நீங்கள் எனக்கு விலைப்பட்டியல் அனுப்ப முடியுமா? |
| My phone battery dies by the afternoon even though I charge it overnight. | நான் ஒரே இரவில் சார்ஜ் செய்தாலும் எனது தொலைபேசி பேட்டரி பிற்பகல்க்குள் இறந்துவிடுகிறது. |
These are unedited outputs, mistakes included, and no native speaker has reviewed them.
Results
chrF++ (higher is better), NFC on both sides, our harness, the same sentences for every system. Ours greedy; indicMT int8 with beam 5 as its card says; Firefox's offline model greedy, as Firefox runs it. Differences (ours minus theirs) are paired: 1,000 bootstrap resamples, 95% interval. Measured 3 to 16 November 2026. Our scores are of the fp32 weights; the int8 build is within 0.07 chrF++ of them, and the comparison with Firefox, re-run on the int8 build, gives the same result.
| Test set (sentences) | Paar (17.3M) | indicMT (153.8M) | IndicTrans2 dist-200M (211.8M) | Firefox's offline model (31.6 MB) |
|---|---|---|---|---|
| FLORES+ devtest (1,012) | 53.86 | 53.95 (-0.08 [-0.55, +0.41]) | 56.67 | 56.67 (-2.81 [-3.24, -2.37]) |
| IN22-Conv (1,503) | 36.12 | 38.14 (-2.02 [-2.43, -1.62]) | 38.55 | 37.11 (-0.98 [-1.38, -0.61]) |
- IN22-Gen: 45.84. Numbers kept (sentences whose every number survives), FLORES+ / IN22-Conv: 98.0% / 98.8%.
- Size: the int8 folder is 20.0 MB; the browser (ONNX int8) files are 28.9 MB. indicMT's int8 files are 169.2 MB.
- Speed (Mac mini, FLORES+ devtest): about 30 ms a sentence on one CPU thread (CTranslate2 int8, median), about 218 sentences a second batched on four threads. In a browser (transformers.js, int8, one thread) about 40 ms a sentence in Chrome and Safari on the same Mac (measured for English → Gujarati). Phones are not measured.
Where it falls short
- It is behind the bigger models: indicMT by 2.0 (IN22-Conv) chrF++, level on FLORES+, IndicTrans2 dist-200M, its teacher, by 2.8 on FLORES+. If you can run a 150-200M model, those translate better.
- Firefox's offline English-to-Tamil model (31.6 MB) is ahead of it by 2.8 (FLORES+) and 1.0 (IN22-Conv) chrF++.
- Some letters are missing from its vocabulary (ஔ, ௌ, ஶ, ௐ and Tamil digits). They come out as "⁇" (
<unk>in transformers.js), or are dropped by the Transformers decoder. 1.3% of FLORES+ outputs carry one. - Idioms and short phrases are often translated word for word, and small words such as "by" (a deadline) can take the wrong sense.
- Names are often mangled, and Latin letters inside names often become "⁇".
- Long formal sentences lose meaning more often than short everyday ones. Conversational Tamil is weak (36.1 on IN22-Conv).
- English to Tamil only. It does not translate into English.
- No native-speaker review of its outputs yet.
- Speed is measured on one Mac mini (its CPU, and Chrome and Safari for the browser build), not on phones.
How it was trained
A Marian encoder-decoder (6 encoder and 2 decoder layers, width 256, one shared 32,000-piece SentencePiece vocabulary), trained from random weights. Its training targets are IndicTrans2 dist-200M's translations (beam 4) of English sentences from IndicCorp v2 (CC0). The sentences were cleaned and deduplicated, about a third were rewritten in a spoken style, and every sentence overlapping FLORES+, NTREX or IN22 was removed before training. Scores are on the test sets, scored once after training.
Intended use and limitations
For translating short English text into Tamil where a large model is too heavy or the text should not leave the device: apps, web pages, offline tools, browser extensions, a first draft for a human translator. It is not meant for legal, medical or official text without a human check. Check names and numbers in the output.
Fine-tuning
The GitHub repository has a recipe (finetune/) for training it further on your own
sentence pairs with Transformers. If you publish a fine-tuned version, set base_model: udgamlabs/Paar-en-ta in its card so it
links back here.
Licence
Apache-2.0. See NOTICE: IndicTrans2 (AI4Bharat, MIT) wrote the training targets, and the English sentences come from
IndicCorp v2 (AI4Bharat, CC0). No third-party weights are included.
Citation
@misc{udgamlabs2026paarta,
title = {Paar: a 17 MB English-to-Tamil translator},
author = {Prasad, Jitesh K},
year = {2026},
howpublished = {Udgam Labs},
url = {https://huggingface.co/udgamlabs/Paar-en-ta}
}
Please also cite IndicTrans2 (Gala et al., 2023, TMLR; arXiv:2305.16307), whose translations it learned from.
About Udgam Labs. Udgam Labs is an independent AI research lab. We work from first principles: before we build, we understand why things work, whether we are training a model, fine-tuning one or applying AI to a new problem. Udgam (उद्गम) is Sanskrit for origin. udgamlabs.com
- Downloads last month
- 28
