ar-fr / README.md
AmerAlreyahi's picture
Add OptimaMT ar-fr
84c826c verified
|
Raw History Blame Contribute Delete
2.79 kB
metadata
license: cc-by-4.0
language:
  - ar
  - fr
pipeline_tag: translation
library_name: transformers.js
base_model: Helsinki-NLP/opus-mt-ar-fr
tags:
  - translation
  - marian
  - opus-mt
  - onnx

OptimaMT ar โ†’ fr (Arabic to French)

Drop-in copy of an ONNX export of Helsinki-NLP/opus-mt-ar-fr at revision e507d7bc8508 (same layout as the Xenova exports) with a lighter merged decoder: ONNX Runtime's fast mode (disable_quant_qdq = 1, 2.3โ€“2.5ร— faster) at half the memory. Same weights, same tokens. Part of OptimaMT: all 51 pairs, named OptimaMT/<src>-<tgt>.

Used in production:

  • OpenCircle, a desktop screen translator for Windows and Linux, ships these models since v0.1.4.
Memory after load Linux Windows Identical tokens
disable_quant_qdq = 1 542 โ†’ 290 MiB (-47 %) 514 โ†’ 265 MiB (-48 %) yes
ONNX Runtime defaults 288 โ†’ 226 MiB (-22 %) 200 โ†’ 170 MiB (-15 %) yes

FLORES-200 devtest (1,012 sentences): the same translations as the original, BLEU 26.01, chrF 53.48 (greedy).

ONNX Runtime 1.31.1, CPU, 4 threads (Linux; Windows in a VM). Interactive results: OptimaMT/results ยท method: REPORT.md.

Use

import { pipeline } from "@huggingface/transformers";

const translator = await pipeline("translation", "OptimaMT/ar-fr", {
  dtype: "q8",
  session_options: { extra: { session: { disable_quant_qdq: "1" } } },
});
const [out] = await translator("ุงู„ู…ู†ุงุฑุฉ ุชู‚ู ุนู„ู‰ ุงู„ุณุงุญู„.");
console.log(out.translation_text);

Python (translate.py: onnxruntime, sentencepiece, numpy):

python translate.py OptimaMT/ar-fr "ุงู„ู…ู†ุงุฑุฉ ุชู‚ู ุนู„ู‰ ุงู„ุณุงุญู„."

Files

onnx/decoder_model_merged_quantized.onnx is rebuilt; tokenizer.json, special_tokens_map.json and tokenizer_config.json were written in the Xenova layout; every other file is the original, byte for byte. Vocabulary: 64,505 tokens.

Licence and credits

  • Weights: OPUS-MT by the University of Helsinki, CC BY 4.0.
  • ONNX export: an ONNX export of Helsinki-NLP/opus-mt-ar-fr at revision e507d7bc8508 (same layout as the Xenova exports).
  • Modified: the decoder's output projection was moved out of its two branches (graph change only). CC BY 4.0.