opus mt en fr

ProviderHelsinki-NLP
Categorytranslation
Licenseapache-2.0
Downloads613
Stars0

Overview

Opus-MT en-fr is a specialized neural machine translation model developed by Helsinki-NLP, designed specifically for high-efficiency English-to-French translation. Unlike general-purpose LLMs, this model is lightweight and optimized for translation tasks, making it ideal for developers who need low-latency performance or local deployment without the overhead of a massive parameter count. It integrates seamlessly into pipelines via the Hugging Face Transformers library, offering a reliable alternative to cloud APIs for applications requiring data privacy or offline capability. While it lacks the conversational nuance of a generative AI, it provides consistent, deterministic translation quality for structured text and documentation.

Highlights

  • Optimized for high-performance English to French translation
  • Lightweight architecture suitable for local edge deployment
  • Apache-2.0 license ensures flexible commercial integration
  • Easy implementation via Hugging Face Transformers library
  • Low-latency alternative to large-scale generative models

Usage

Install
# Install Hugging Face transformers
pip install transformers torch
SDK Usage
# Load model with transformers
from transformers import AutoModel, AutoTokenizer

model = AutoModel.from_pretrained("Helsinki-NLP/opus-mt-en-fr")
tokenizer = AutoTokenizer.from_pretrained("Helsinki-NLP/opus-mt-en-fr")

Hugging Face Download

We recommend downloading the model via the Hugging Face CLI or Hub SDK.

Guidance:Before downloading, install huggingface_hub with:

Guidance
pip install -U huggingface_hub

CLI Download

Download the full repository

Download the full repository
huggingface-cli download Helsinki-NLP/opus-mt-en-fr

Download a single file to a local folder (e.g. config.json into ./dir)

Download a single file to a local folder (e.g. config.json into ./dir)
huggingface-cli download Helsinki-NLP/opus-mt-en-fr config.json --local-dir ./dir

See the official docs for more CLI options

SDK Download

SDK Download
# 模型下载
from huggingface_hub import snapshot_download
model_dir = snapshot_download('Helsinki-NLP/opus-mt-en-fr')

Git Download

Make sure git-lfs is installed first

Git Download
git lfs install
git clone https://huggingface.co/Helsinki-NLP/opus-mt-en-fr

To skip LFS large-file downloads, use:

Skip LFS
GIT_LFS_SKIP_SMUDGE=1 git clone https://huggingface.co/Helsinki-NLP/opus-mt-en-fr

Model files are hosted on the Hugging Face Hub — download directly via HF CLI / SDK / Git, not through this site.

PyTorch / Transformers Usage

Install Transformers

Install Transformers
pip install -U transformers torch

Load the model and run inference

Load the model and run inference
from transformers import AutoModelForCausalLM, AutoTokenizer

model = AutoModelForCausalLM.from_pretrained('Helsinki-NLP/opus-mt-en-fr')
tokenizer = AutoTokenizer.from_pretrained('Helsinki-NLP/opus-mt-en-fr')

Model Download

We recommend downloading the model via the ModelScope CLI or SDK.

Guidance:Before downloading, install ModelScope with:

Guidance
pip install modelscope

CLI Download

Download the full repository

Download the full repository
modelscope download --model Helsinki-NLP/opus-mt-en-fr

Download a single file to a local folder (e.g. README.md into ./dir)

Download a single file to a local folder (e.g. README.md into ./dir)
modelscope download --model Helsinki-NLP/opus-mt-en-fr README.md --local_dir ./dir

See the docs for more CLI options

SDK Download

SDK Download
# 模型下载
from modelscope import snapshot_download
model_dir = snapshot_download('Helsinki-NLP/opus-mt-en-fr')

Git Download

Make sure git-lfs is installed first

Git Download
git lfs install
git clone https://www.modelscope.cn/Helsinki-NLP/opus-mt-en-fr.git

To skip LFS large-file downloads, use:

Skip LFS
GIT_LFS_SKIP_SMUDGE=1 git clone https://www.modelscope.cn/Helsinki-NLP/opus-mt-en-fr.git

ModelScope 模型页直接下载模型文件;无需将模型文件放在本站服务器。

Notebook Quickstart

Install the ModelScope library

Install the ModelScope library
pip install "modelscope[audio,cv,nlp,multi-modal,science]" -f https://modelscope.oss-cn-beijing.aliyuncs.com/releases/repo.html

Load the model and run inference

Load the model and run inference
from modelscope.pipelines import pipeline
from modelscope.utils.constant import Tasks

p = pipeline('text-generation', 'Helsinki-NLP/opus-mt-en-fr')

Full Documentation

来源: HuggingFace

---
pipeline_tag: translation
license: apache-2.0
---

opus-mt-en-fr

  • source languages: en
  • target languages: fr
  • dataset: opus
  • model: transformer-align
  • pre-processing: normalization + SentencePiece

Benchmarks

| testset | BLEU | chr-F |
|-----------------------|-------|-------|
| newsdiscussdev2015-enfr.en.fr | 33.8 | 0.602 |
| newsdiscusstest2015-enfr.en.fr | 40.0 | 0.643 |
| newssyscomb2009.en.fr | 29.8 | 0.584 |
| news-test2008.en.fr | 27.5 | 0.554 |
| newstest2009.en.fr | 29.4 | 0.577 |
| newstest2010.en.fr | 32.7 | 0.596 |
| newstest2011.en.fr | 34.3 | 0.611 |
| newstest2012.en.fr | 31.8 | 0.592 |
| newstest2013.en.fr | 33.2 | 0.589 |
| Tatoeba.en.fr | 50.5 | 0.672 |

Join our Telegram