Skip to main content

GitHub repository. RETURNN paper 2016, RETURNN paper 2018.

RETURNN - RWTH extensible training framework for universal recurrent neural networks, is a PyTorch/TensorFlow-based implementation of modern recurrent neural network architectures. It is optimized for fast and reliable training of recurrent neural networks in a multi-GPU environment.

The high-level features and goals of RETURNN are:

  • Simplicity

    • Writing config / code is simple & straight-forward (setting up experiment, defining model)

    • Debugging in case of problems is simple

    • Reading config / code is simple (defined model, training, decoding all becomes clear)

  • Flexibility

    • Allow for many different kinds of experiments / models

  • Efficiency

    • Training speed

    • Decoding speed

All items are important for research, decoding speed is esp. important for production.

See our Interspeech 2020 tutorial “Efficient and Flexible Implementation of Machine Learning for ASR and MT” video (slides) with an introduction of the core concepts.

More specific features include:

  • Mini-batch training of feed-forward neural networks

  • Sequence-chunking based batch training for recurrent neural networks

  • Long short-term memory recurrent neural networks including our own fast CUDA kernel

  • Multidimensional LSTM (GPU only, there is no CPU version)

  • Memory management for large data sets

  • Work distribution across multiple devices

  • Flexible and fast architecture which allows all kinds of encoder-attention-decoder models

See documentation. See basic usage and technological overview.

Here is the video recording of a RETURNN overview talk (slides, exercise sheet; hosted by eBay).

There are many example demos which work on artificially generated data, i.e. they should work as-is.

There are some real-world examples such as setups for speech recognition on the Switchboard or LibriSpeech corpus.

Some benchmark setups against other frameworks can be found here. The results are in the RETURNN paper 2016. Performance benchmarks of our LSTM kernel vs CuDNN and other TensorFlow kernels are in TensorFlow LSTM benchmark.

There is also a wiki. Questions can also be asked on StackOverflow using the RETURNN tag.

https://github.com/rwth-i6/returnn/workflows/CI/badge.svg

Dependencies

pip dependencies are listed in requirements.txt and requirements-dev, although some parts of the code may require additional dependencies (e.g. librosa, resampy) on-demand.

RETURNN supports Python >= 3.8. Bumps to the minimum Python version are listed in CHANGELOG.md.

TensorFlow-based setups require TensorFlow >= 2.2.

PyTorch-based setups require Torch >= 1.0.

Download files

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

Source Distribution

returnn-1.20260908.114922.tar.gz (2.8 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

returnn-1.20260908.114922-py3-none-any.whl (1.9 MB view details)

Uploaded Python 3

File details

Details for the file returnn-1.20260908.114922.tar.gz.

File metadata

  • Download URL: returnn-1.20260908.114922.tar.gz
  • Upload date:
  • Size: 2.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for returnn-1.20260908.114922.tar.gz
Algorithm Hash digest
SHA256 7bb9e71aad36c454ff3ab8e5afafdd2bcb059f2da8bb3db4fc5ad50fd94fed83
MD5 8eeed990686590b671521b2226198b61
BLAKE2b-256 1e73b9b4fceff3b65c8f4001682aa4112e03f55f3c131dcc08f12d3524c8a3a1

See more details on using hashes here.

File details

Details for the file returnn-1.20260908.114922-py3-none-any.whl.

File metadata

File hashes

Hashes for returnn-1.20260908.114922-py3-none-any.whl
Algorithm Hash digest
SHA256 60030caa4da45c950eea2bf0d7f6e39d01c81142cf1fcf1c8074fa5ecd8e7614
MD5 713f345119a6924b39dc6a2570edc6c4
BLAKE2b-256 0503a2c4632af35432ff6fdabb706548cfea78bc9bdb30f9e2a0481b796c5873

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

1.20260908.114922 This release

2 files

1.20251027.117

2 files

1.20250419.437

2 files

1.20250125.618

1 file

1.20241224.5643

1 file

1.20241026.3853

1 file

1.20241020.5643

1 file

1.20241017.4429

1 file

1.20240919.2417

1 file

1.20240824.1611

1 file

1.20240725.5736

1 file

1.20240721.1359

1 file

1.20240720.4642

1 file

1.20240712.3448

1 file

1.20240206.450

1 file

1.20240119.5010

1 file

1.20240119.2721

1 file

1.20240112.5115

1 file

1.20240112.3922

1 file

1.20240110.555

1 file

1.20231220.2423

1 file

1.20231119.3753

1 file

1.20231023.3339

1 file

1.20231016.1357

1 file

1.20231015.3040

1 file

1.20231011.823

1 file

1.20231001.3920

1 file

1.20230921.2233

1 file

1.20230825.4326

1 file

1.20230825.1832

1 file

1.20230824.648

1 file

1.20230817.5435

1 file

1.20230816.2116

1 file

1.20230811.3923

1 file

1.20230701.3857

1 file

1.20230603.803

1 file

1.20230512.5307

1 file

1.20230501.4306

1 file

1.20230429.4240

1 file

1.20230419.2603

1 file

1.20230418.5121

1 file

1.20230411.4301

1 file

1.20230401.5406

1 file

1.20230401.1002

1 file

1.20230215.2756

1 file

1.20230215.1316

1 file

1.20221214.2548

1 file

1.20221117.3012

1 file

1.20221025.1559

1 file

1.20221013.1347

1 file

1.20220924.1137

1 file

1.20220923.1938

1 file

1.20220916.3933

1 file

1.20220915.1218

1 file

1.20220912.4655

1 file

1.20220825.5

1 file

1.20220714.1853

1 file

1.20220706.113

1 file

1.20220511.524

1 file

1.20220417.5223

1 file

1.20220415.3232

1 file

1.20220415.1732

1 file

1.20220314.4259

1 file

1.20220313.1219

1 file

1.20220216.3340

1 file

1.20211229.842

1 file

1.20211228.4931

1 file

1.20211222.4407

1 file

1.20211222.759

1 file

1.0.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page