auto.rst 4.26 KB
Newer Older
1
AutoClasses
Sylvain Gugger's avatar
Sylvain Gugger committed
2
-----------------------------------------------------------------------------------------------------------------------
thomwolf's avatar
thomwolf committed
3

4
In many cases, the architecture you want to use can be guessed from the name or the path of the pretrained model you
Sylvain Gugger's avatar
Sylvain Gugger committed
5
6
are supplying to the :obj:`from_pretrained()` method. AutoClasses are here to do this job for you so that you
automatically retrieve the relevant model given the name/path to the pretrained weights/config/vocabulary.
thomwolf's avatar
thomwolf committed
7

8
9
Instantiating one of :class:`~transformers.AutoConfig`, :class:`~transformers.AutoModel`, and
:class:`~transformers.AutoTokenizer` will directly create a class of the relevant architecture. For instance
thomwolf's avatar
thomwolf committed
10
11


12
13
14
15
.. code-block:: python

    model = AutoModel.from_pretrained('bert-base-cased')

sgugger's avatar
Extra )  
sgugger committed
16
will create a model that is an instance of :class:`~transformers.BertModel`.
17
18
19
20
21

There is one class of :obj:`AutoModel` for each task, and for each backend (PyTorch or TensorFlow).


AutoConfig
Sylvain Gugger's avatar
Sylvain Gugger committed
22
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
thomwolf's avatar
thomwolf committed
23

24
.. autoclass:: transformers.AutoConfig
thomwolf's avatar
thomwolf committed
25
26
27
    :members:


28
AutoTokenizer
Sylvain Gugger's avatar
Sylvain Gugger committed
29
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Lysandre's avatar
Lysandre committed
30
31
32
33
34

.. autoclass:: transformers.AutoTokenizer
    :members:


35
AutoModel
Sylvain Gugger's avatar
Sylvain Gugger committed
36
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
thomwolf's avatar
thomwolf committed
37

38
.. autoclass:: transformers.AutoModel
thomwolf's avatar
thomwolf committed
39
40
41
    :members:


42
AutoModelForPreTraining
Sylvain Gugger's avatar
Sylvain Gugger committed
43
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
thomwolf's avatar
thomwolf committed
44
45
46
47
48

.. autoclass:: transformers.AutoModelForPreTraining
    :members:


49
AutoModelWithLMHead
Sylvain Gugger's avatar
Sylvain Gugger committed
50
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
thomwolf's avatar
thomwolf committed
51

Lysandre's avatar
Lysandre committed
52
.. autoclass:: transformers.AutoModelWithLMHead
thomwolf's avatar
thomwolf committed
53
    :members:
Lysandre's avatar
Lysandre committed
54
55


56
AutoModelForSequenceClassification
Sylvain Gugger's avatar
Sylvain Gugger committed
57
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Lysandre's avatar
Lysandre committed
58
59
60
61
62

.. autoclass:: transformers.AutoModelForSequenceClassification
    :members:


63
AutoModelForMultipleChoice
Sylvain Gugger's avatar
Sylvain Gugger committed
64
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Lysandre's avatar
Lysandre committed
65

66
.. autoclass:: transformers.AutoModelForMultipleChoice
Lysandre's avatar
Lysandre committed
67
68
69
    :members:


70
AutoModelForTokenClassification
Sylvain Gugger's avatar
Sylvain Gugger committed
71
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Lysandre's avatar
Lysandre committed
72
73
74
75

.. autoclass:: transformers.AutoModelForTokenClassification
    :members:

76
77

AutoModelForQuestionAnswering
Sylvain Gugger's avatar
Sylvain Gugger committed
78
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
79
80
81
82
83
84

.. autoclass:: transformers.AutoModelForQuestionAnswering
    :members:


TFAutoModel
Sylvain Gugger's avatar
Sylvain Gugger committed
85
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
86
87
88
89
90

.. autoclass:: transformers.TFAutoModel
    :members:


91
TFAutoModelForPreTraining
Sylvain Gugger's avatar
Sylvain Gugger committed
92
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
93
94
95
96
97

.. autoclass:: transformers.TFAutoModelForPreTraining
    :members:


98
TFAutoModelWithLMHead
Sylvain Gugger's avatar
Sylvain Gugger committed
99
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
100
101
102
103
104

.. autoclass:: transformers.TFAutoModelWithLMHead
    :members:


105
TFAutoModelForSequenceClassification
Sylvain Gugger's avatar
Sylvain Gugger committed
106
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
107
108
109
110
111

.. autoclass:: transformers.TFAutoModelForSequenceClassification
    :members:


112
TFAutoModelForMultipleChoice
Sylvain Gugger's avatar
Sylvain Gugger committed
113
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
114

115
.. autoclass:: transformers.TFAutoModelForMultipleChoice
116
117
118
    :members:


119
TFAutoModelForTokenClassification
Sylvain Gugger's avatar
Sylvain Gugger committed
120
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
121
122
123

.. autoclass:: transformers.TFAutoModelForTokenClassification
    :members:
124
125
126


TFAutoModelForQuestionAnswering
Sylvain Gugger's avatar
Sylvain Gugger committed
127
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
128
129
130

.. autoclass:: transformers.TFAutoModelForQuestionAnswering
    :members: