Catalog PyPI
PACKAGE EXPLORERView in registry

admin-torch

PyPI

Plug-in-and-Play Toolbox for Stablizing Transformer Training

Versions collected1
Direct dependencies1From release 0.1.0
Last observed20 Oct, 19:42 UTC

README

Version 0.1.0 documentation

GitHub PWCMaintenance

Admin-Torch

Transformers Training **Stabilized**

What's New? • Key Idea • How To Use • Docs • Examples • Citation • License

Here, we provide a plug-in-and-play implementation of Admin, which stabilizes previously-diverged Transformer training and achieves better performance, without introducing additional hyper-parameters. The design of Admin is half-precision friendly and can be reparameterized into the original Transformer.


What's New?

Beyond the original admin implementation:

  1. admin-torch removed the profilling stage and is plug-in-and-play.
  2. admin-torch's implementation is more robust (see below).

Comparison w. the DeepNet Init and the Original Admin Init (on WMT'17).

Regular batch size (8x4096)Huge batch size (128x4096)
Original Admin✅❌
DeepNet❌✅
admin-torch✅✅

More details can be found in our example.

Key Idea

What complicates Transformer training?

For Transformer f, input x, randomly initialized weight w, we describe its stability (output_change_scale) as

In our study, we show that, an original N-layer Transformer's output_change_scale is O(n), which unstabilizes its training. Admin stabilize Transformer's training by regulating this scale to O(logn) or O(1).

More details can be found in our paper.

How to use?

install

pip install admin-torch

import

import admin-torch

enjoy

def __init__(self, ...):
...
+(residual = admin-torch.as_module(self, self.number_of_sub_layers))+
...

def forward(self, ):
...
-!x = x + f(x)!-
+(x = residual(x, f(x)))+
x = self.LN(x)
...

An elaborated example can be found at our doc, and a real working example can be found at LiyuanLucasLiu/fairseq (training recipe is available at our example).

Citation

Please cite the following papers if you found our model useful. Thanks!

Liyuan Liu, Xiaodong Liu, Jianfeng Gao, Weizhu Chen, and Jiawei Han (2020). Understanding the Difficulty of Training Transformers. Proc. 2020 Conf. on Empirical Methods in Natural Language Processing (EMNLP'20).

@inproceedings{liu2020admin,
  title={Understanding the Difficulty of Training Transformers},
  author = {Liu, Liyuan and Liu, Xiaodong and Gao, Jianfeng and Chen, Weizhu and Han, Jiawei},
  booktitle = {Proceedings of the 2020 Conference on Empirical Methods in Natural Language Processing (EMNLP 2020)},
  year={2020}
}

Xiaodong Liu, Kevin Duh, Liyuan Liu, and Jianfeng Gao (2020). Very Deep Transformers for Neural Machine Translation. arXiv preprint arXiv:2008.07772 (2020).

@inproceedings{liu_deep_2020,
 author = {Liu, Xiaodong and Duh, Kevin and Liu, Liyuan and Gao, Jianfeng},
 booktitle = {arXiv:2008.07772 [cs]},
 title = {Very Deep Transformers for Neural Machine Translation},
 year = {2020}
}

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Versions 1

Collected releases
VersionPublishedDirect dependenciesOpen version
0.1.012 Apr 20221

Package advisories

0
No matching advisories collected

This describes our collected data; it is not a security assessment.

Repository

PENDING
microsoft/admin-torch

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 19:42 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package:d7d9a123f7b2acd4e2094d4ce4fecf89e73b35b934057c1f603678afe146420a