Skip to main content

Machine Translation Quality Estimation Toolkit

Project description

OpenKiwi Logo


PyPI version python versions CircleCI Code Climate coverage Code Style GitHub last commit

Open-Source Machine Translation Quality Estimation in PyTorch

Quality estimation (QE) is one of the missing pieces of machine translation: its goal is to evaluate a translation system’s quality without access to reference translations. We present OpenKiwi, a Pytorch-based open-source framework that implements the best QE systems from WMT 2015-18 shared tasks, making it easy to experiment with these models under the same framework. Using OpenKiwi and a stacked combination of these models we have achieved state-of-the-art results on word-level QE on the WMT 2018 English-German dataset.

News

  • An experimental demonstration interface called OpenKiwi Tasting has been released on GitHub and can be checked out in Streamlit Share.

  • A new major version (2.0.0) of OpenKiwi has been released. Introducing HuggingFace Transformers support and adoption of Pytorch-lightning. For a condensed view of changed, check the changelog

  • Following our nomination in early July, we are happy to announce we won the Best Demo Paper at ACL 2019! Congratulations to the whole team and huge thanks for supporters and issue reporters.

  • Check out the published paper.

  • We have released the OpenKiwi tutorial we presented at MT Marathon 2019.

Features

  • Framework for training QE models and using pre-trained models for evaluating MT.
  • Supports both word and sentence-level (HTER or z-score) Quality estimation.
  • Implementation of five QE systems in Pytorch: NuQE [2, 3], predictor-estimator [4, 5], BERT-Estimator [6], XLM-Estimator [6] and XLMR-Estimator
  • Older systems only supported in versions <=2.0.0: QUETCH [1], APE-QE [3] and a stacked ensemble with a linear system [2, 3].
  • Easy to use API. Import it as a package in other projects or run from the command line.
  • Easy to track and reproduce experiments via yaml configuration files.
  • Based on Pytorch-Lightning making the code easier to scale, use and keep up-do-date with engineering advances.
  • Implemented using HuggingFace Transformers library to allow easy access to state-of-the-art pre-trained models.

Quick Installation

To install OpenKiwi as a package, simply run

pip install openkiwi

You can now

import kiwi

inside your project or run in the command line

kiwi

Optionally, if you'd like to take advantage of our MLflow integration, simply install it in the same virtualenv as OpenKiwi:

pip install openkiwi[mlflow]

Getting Started

Detailed usage examples and instructions can be found in the Full Documentation.

Contributing

We welcome contributions to improve OpenKiwi. Please refer to CONTRIBUTING.md for quick instructions or to contributing instructions for more detailed instructions on how to set up your development environment.

License

OpenKiwi is Affero GPL licensed. You can see the details of this license in LICENSE.

Citation

If you use OpenKiwi, please cite the following paper: OpenKiwi: An Open Source Framework for Quality Estimation.

@inproceedings{openkiwi,
    author = {Fábio Kepler and
              Jonay Trénous and
              Marcos Treviso and
              Miguel Vera and
              André F. T. Martins},
    title  = {Open{K}iwi: An Open Source Framework for Quality Estimation},
    year   = {2019},
    booktitle = {Proceedings of the 57th Annual Meeting of the Association for Computational Linguistics--System Demonstrations},
    pages  = {117--122},
    month  = {July},
    address = {Florence, Italy},
    url    = {https://www.aclweb.org/anthology/P19-3020},
    organization = {Association for Computational Linguistics},
}

References

[1] Kreutzer et al. (2015): QUality Estimation from ScraTCH (QUETCH): Deep Learning for Word-level Translation Quality Estimation
[2] Martins et al. (2016): Unbabel's Participation in the WMT16 Word-Level Translation Quality Estimation Shared Task
[3] Martins et al. (2017): Pushing the Limits of Translation Quality Estimation
[4] Kim et al. (2017): Predictor-Estimator using Multilevel Task Learning with Stack Propagation for Neural Quality Estimation
[5] Wang et al. (2018): Alibaba Submission for WMT18 Quality Estimation Task
[6] Kepler et al. (2019): Unbabel’s Participation in the WMT19 Translation Quality Estimation Shared Task

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

openkiwi-2.1.0.tar.gz (108.4 kB view details)

Uploaded Source

Built Distribution

openkiwi-2.1.0-py3-none-any.whl (186.5 kB view details)

Uploaded Python 3

File details

Details for the file openkiwi-2.1.0.tar.gz.

File metadata

  • Download URL: openkiwi-2.1.0.tar.gz
  • Upload date:
  • Size: 108.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.4 CPython/3.7.9 Linux/4.15.0-1077-aws

File hashes

Hashes for openkiwi-2.1.0.tar.gz
Algorithm Hash digest
SHA256 07733db5acea66773eb1ef756d67e1ef173ccb29e5086332423169ef15c881f8
MD5 a80ddfff43097357beb8439084ccbd7a
BLAKE2b-256 49e3013b5edc3e8aa7d45261c89049e4c0b5063b3034b806acd36c7f340f0232

See more details on using hashes here.

File details

Details for the file openkiwi-2.1.0-py3-none-any.whl.

File metadata

  • Download URL: openkiwi-2.1.0-py3-none-any.whl
  • Upload date:
  • Size: 186.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.4 CPython/3.7.9 Linux/4.15.0-1077-aws

File hashes

Hashes for openkiwi-2.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 59479a638923f13a0eaa4af2f567232694e45aed0ec152e9b91bf8adbc5885ed
MD5 1621f11f78e130210017773f3261bc8e
BLAKE2b-256 d2ee1d29b05244d3ce74e5b46f9ef9a17a2b2ba5bf5a2824800dd1a8cb0da234

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page