---
license: apache-2.0
base_model: Helsinki-NLP/opus-mt-en-hy
base_model_relation: quantized
tags:
  - onnx
  - translation
  - marian
library_name: transformers
pipeline_tag: translation
language:
  - en
  - hy
---

# opus-mt-en-hy-onnx

ONNX export (fp32 + dynamic int8) of [`Helsinki-NLP/opus-mt-en-hy`](https://huggingface.co/Helsinki-NLP/opus-mt-en-hy),
a Marian (en -> hy) translation model from the Helsinki-NLP OPUS-MT project.

**License:** apache-2.0, inherited unchanged from the base model.

## Contents

| Files | What it is |
|---|---|
| `encoder_model.onnx`, `decoder_model.onnx`, `decoder_with_past_model.onnx` | ONNX, float32 |
| `int8/` | same three graphs, dynamic int8 (`QInt8`, `MatMul` only, `/lm_head/MatMul` excluded) |
| `source.spm`, `target.spm`, `vocab.json` | `MarianTokenizer` over the original sentencepiece models |

fp32 size: 333 MB (three graphs) | int8 size: 144 MB

## Usage

```python
from optimum.onnxruntime import ORTModelForSeq2SeqLM
from transformers import AutoTokenizer

repo = "TigreGotico/opus-mt-en-hy-onnx"
tok = AutoTokenizer.from_pretrained(repo)
model = ORTModelForSeq2SeqLM.from_pretrained(repo, use_cache=True, use_merged=False)  # fp32
# int8: ORTModelForSeq2SeqLM.from_pretrained(repo, subfolder="int8", use_cache=True, use_merged=False)
inputs = tok("The weather is very nice today.", return_tensors="pt")
out = model.generate(**inputs, num_beams=4, max_new_tokens=64)
print(tok.decode(out[0], skip_special_tokens=True))
```

## Parity with the original PyTorch model

10 general-domain English sentences, exact-string-match of generated output against
`MarianMTModel.generate()` on the original `Helsinki-NLP/opus-mt-en-hy` checkpoint.

```yaml
parity:
  fp32_greedy: 1.00   # 10/10
  fp32_beam4:  1.00   # 10/10
  int8_greedy: 0.70   # 7/10
  int8_beam4:  0.70   # 7/10
```

| Decoding | fp32 exact match | int8 exact match |
|---|---|---|
| greedy (num_beams=1) | 10/10 (100.0%) | 7/10 (70.0%) |
| beam=4 | 10/10 (100.0%) | 7/10 (70.0%) |

fp32 is a faithful reproduction of the original model at both decoding
settings. int8 dynamic quantization causes some quality loss on this
checkpoint. Prefer fp32; int8 is provided for size-constrained deployments
where some quality loss is acceptable.