This portal provides a detailled documentation of the OpenNMT toolkit. It describes how to use the PyTorch project and how it works.


1. Install PyTorch

2. Clone the OpenNMT-py repository:

git clone https://github.com/OpenNMT/OpenNMT-py
cd OpenNMT-py

3. Install required libraries

pip install -r requirements.txt

And you are ready to go! Take a look at the quickstart to familiarize yourself with the main training workflow.

Alternatively you can use Docker to install with nvidia-docker. The main Dockerfile is included in the root directory.


When using OpenNMT for research please cite our OpenNMT technical report

  author    = {Guillaume Klein and
               Yoon Kim and
               Yuntian Deng and
               Jean Senellart and
               Alexander M. Rush},
  title     = {OpenNMT: Open-Source Toolkit for Neural Machine Translation},
  booktitle = {Proc. ACL},
  year      = {2017},
  url       = {https://doi.org/10.18653/v1/P17-4012},
  doi       = {10.18653/v1/P17-4012}

Additional resources

You can find additional help or tutorials in the following resources: