configuration_auto.py 34.6 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
# coding=utf-8
# Copyright 2018 The HuggingFace Inc. team.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
Sylvain Gugger's avatar
Sylvain Gugger committed
15
""" Auto Config class."""
16
import importlib
17
import re
18
import warnings
19
from collections import OrderedDict
20
from typing import List, Union
21

Sylvain Gugger's avatar
Sylvain Gugger committed
22
from ...configuration_utils import PretrainedConfig
23
from ...dynamic_module_utils import get_class_from_dynamic_module
24
from ...utils import CONFIG_NAME, logging
Aymeric Augustin's avatar
Aymeric Augustin committed
25

26

27
28
logger = logging.get_logger(__name__)

29
30
31
CONFIG_MAPPING_NAMES = OrderedDict(
    [
        # Add configs here
32
33
        ("albert", "AlbertConfig"),
        ("bart", "BartConfig"),
34
        ("beit", "BeitConfig"),
35
36
37
38
39
40
        ("bert", "BertConfig"),
        ("bert-generation", "BertGenerationConfig"),
        ("big_bird", "BigBirdConfig"),
        ("bigbird_pegasus", "BigBirdPegasusConfig"),
        ("blenderbot", "BlenderbotConfig"),
        ("blenderbot-small", "BlenderbotSmallConfig"),
Younes Belkada's avatar
Younes Belkada committed
41
        ("bloom", "BloomConfig"),
42
        ("camembert", "CamembertConfig"),
43
44
        ("canine", "CanineConfig"),
        ("clip", "CLIPConfig"),
rooa's avatar
rooa committed
45
        ("codegen", "CodeGenConfig"),
46
        ("conditional_detr", "ConditionalDetrConfig"),
47
48
49
        ("convbert", "ConvBertConfig"),
        ("convnext", "ConvNextConfig"),
        ("ctrl", "CTRLConfig"),
NielsRogge's avatar
NielsRogge committed
50
        ("cvt", "CvtConfig"),
51
52
53
54
55
56
        ("data2vec-audio", "Data2VecAudioConfig"),
        ("data2vec-text", "Data2VecTextConfig"),
        ("data2vec-vision", "Data2VecVisionConfig"),
        ("deberta", "DebertaConfig"),
        ("deberta-v2", "DebertaV2Config"),
        ("decision_transformer", "DecisionTransformerConfig"),
NielsRogge's avatar
NielsRogge committed
57
        ("deformable_detr", "DeformableDetrConfig"),
58
59
        ("deit", "DeiTConfig"),
        ("detr", "DetrConfig"),
60
        ("distilbert", "DistilBertConfig"),
NielsRogge's avatar
NielsRogge committed
61
        ("donut-swin", "DonutSwinConfig"),
62
63
64
65
        ("dpr", "DPRConfig"),
        ("dpt", "DPTConfig"),
        ("electra", "ElectraConfig"),
        ("encoder-decoder", "EncoderDecoderConfig"),
66
        ("ernie", "ErnieConfig"),
67
        ("esm", "EsmConfig"),
68
69
70
71
72
73
74
        ("flaubert", "FlaubertConfig"),
        ("flava", "FlavaConfig"),
        ("fnet", "FNetConfig"),
        ("fsmt", "FSMTConfig"),
        ("funnel", "FunnelConfig"),
        ("glpn", "GLPNConfig"),
        ("gpt2", "GPT2Config"),
75
        ("gpt_neo", "GPTNeoConfig"),
76
        ("gpt_neox", "GPTNeoXConfig"),
77
        ("gpt_neox_japanese", "GPTNeoXJapaneseConfig"),
78
        ("gptj", "GPTJConfig"),
79
        ("groupvit", "GroupViTConfig"),
80
        ("hubert", "HubertConfig"),
81
        ("ibert", "IBertConfig"),
82
83
84
        ("imagegpt", "ImageGPTConfig"),
        ("layoutlm", "LayoutLMConfig"),
        ("layoutlmv2", "LayoutLMv2Config"),
NielsRogge's avatar
NielsRogge committed
85
        ("layoutlmv3", "LayoutLMv3Config"),
86
        ("led", "LEDConfig"),
87
        ("levit", "LevitConfig"),
88
        ("longformer", "LongformerConfig"),
Daniel Stancl's avatar
Daniel Stancl committed
89
        ("longt5", "LongT5Config"),
90
91
92
        ("luke", "LukeConfig"),
        ("lxmert", "LxmertConfig"),
        ("m2m_100", "M2M100Config"),
93
        ("marian", "MarianConfig"),
NielsRogge's avatar
NielsRogge committed
94
        ("markuplm", "MarkupLMConfig"),
95
        ("maskformer", "MaskFormerConfig"),
96
        ("mbart", "MBartConfig"),
Chan Woo Kim's avatar
Chan Woo Kim committed
97
        ("mctct", "MCTCTConfig"),
98
        ("megatron-bert", "MegatronBertConfig"),
99
        ("mobilebert", "MobileBertConfig"),
100
        ("mobilevit", "MobileViTConfig"),
101
        ("mpnet", "MPNetConfig"),
102
        ("mt5", "MT5Config"),
StevenTang1998's avatar
StevenTang1998 committed
103
        ("mvp", "MvpConfig"),
104
        ("nezha", "NezhaConfig"),
105
106
        ("nystromformer", "NystromformerConfig"),
        ("openai-gpt", "OpenAIGPTConfig"),
Younes Belkada's avatar
Younes Belkada committed
107
        ("opt", "OPTConfig"),
108
        ("owlvit", "OwlViTConfig"),
109
        ("pegasus", "PegasusConfig"),
Jason Phang's avatar
Jason Phang committed
110
        ("pegasus_x", "PegasusXConfig"),
111
112
113
114
115
116
117
        ("perceiver", "PerceiverConfig"),
        ("plbart", "PLBartConfig"),
        ("poolformer", "PoolFormerConfig"),
        ("prophetnet", "ProphetNetConfig"),
        ("qdqbert", "QDQBertConfig"),
        ("rag", "RagConfig"),
        ("realm", "RealmConfig"),
118
        ("reformer", "ReformerConfig"),
119
120
121
122
        ("regnet", "RegNetConfig"),
        ("rembert", "RemBertConfig"),
        ("resnet", "ResNetConfig"),
        ("retribert", "RetriBertConfig"),
123
        ("roberta", "RobertaConfig"),
124
125
126
127
        ("roformer", "RoFormerConfig"),
        ("segformer", "SegformerConfig"),
        ("sew", "SEWConfig"),
        ("sew-d", "SEWDConfig"),
128
        ("speech-encoder-decoder", "SpeechEncoderDecoderConfig"),
129
130
        ("speech_to_text", "Speech2TextConfig"),
        ("speech_to_text_2", "Speech2Text2Config"),
Ori Ram's avatar
Ori Ram committed
131
        ("splinter", "SplinterConfig"),
132
133
        ("squeezebert", "SqueezeBertConfig"),
        ("swin", "SwinConfig"),
134
        ("swinv2", "Swinv2Config"),
135
136
        ("t5", "T5Config"),
        ("tapas", "TapasConfig"),
137
        ("time_series_transformer", "TimeSeriesTransformerConfig"),
Carl's avatar
Carl committed
138
        ("trajectory_transformer", "TrajectoryTransformerConfig"),
139
140
        ("transfo-xl", "TransfoXLConfig"),
        ("trocr", "TrOCRConfig"),
141
        ("unispeech", "UniSpeechConfig"),
142
143
        ("unispeech-sat", "UniSpeechSatConfig"),
        ("van", "VanConfig"),
NielsRogge's avatar
NielsRogge committed
144
        ("videomae", "VideoMAEConfig"),
145
146
147
148
149
150
        ("vilt", "ViltConfig"),
        ("vision-encoder-decoder", "VisionEncoderDecoderConfig"),
        ("vision-text-dual-encoder", "VisionTextDualEncoderConfig"),
        ("visual_bert", "VisualBertConfig"),
        ("vit", "ViTConfig"),
        ("vit_mae", "ViTMAEConfig"),
151
        ("vit_msn", "ViTMSNConfig"),
152
        ("wav2vec2", "Wav2Vec2Config"),
153
        ("wav2vec2-conformer", "Wav2Vec2ConformerConfig"),
Patrick von Platen's avatar
Patrick von Platen committed
154
        ("wavlm", "WavLMConfig"),
NielsRogge's avatar
NielsRogge committed
155
        ("xclip", "XCLIPConfig"),
156
157
158
159
160
161
162
163
        ("xglm", "XGLMConfig"),
        ("xlm", "XLMConfig"),
        ("xlm-prophetnet", "XLMProphetNetConfig"),
        ("xlm-roberta", "XLMRobertaConfig"),
        ("xlm-roberta-xl", "XLMRobertaXLConfig"),
        ("xlnet", "XLNetConfig"),
        ("yolos", "YolosConfig"),
        ("yoso", "YosoConfig"),
164
165
    ]
)
166

167
CONFIG_ARCHIVE_MAP_MAPPING_NAMES = OrderedDict(
168
    [
NielsRogge's avatar
NielsRogge committed
169
        # Add archive maps here)
170
171
        ("albert", "ALBERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("bart", "BART_PRETRAINED_CONFIG_ARCHIVE_MAP"),
172
        ("beit", "BEIT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
173
174
175
176
177
        ("bert", "BERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("big_bird", "BIG_BIRD_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("bigbird_pegasus", "BIGBIRD_PEGASUS_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("blenderbot", "BLENDERBOT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("blenderbot-small", "BLENDERBOT_SMALL_PRETRAINED_CONFIG_ARCHIVE_MAP"),
Younes Belkada's avatar
Younes Belkada committed
178
        ("bloom", "BLOOM_PRETRAINED_CONFIG_ARCHIVE_MAP"),
179
        ("camembert", "CAMEMBERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
180
181
        ("canine", "CANINE_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("clip", "CLIP_PRETRAINED_CONFIG_ARCHIVE_MAP"),
rooa's avatar
rooa committed
182
        ("codegen", "CODEGEN_PRETRAINED_CONFIG_ARCHIVE_MAP"),
183
        ("conditional_detr", "CONDITIONAL_DETR_PRETRAINED_CONFIG_ARCHIVE_MAP"),
184
        ("convbert", "CONVBERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
185
        ("convnext", "CONVNEXT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
186
        ("ctrl", "CTRL_PRETRAINED_CONFIG_ARCHIVE_MAP"),
NielsRogge's avatar
NielsRogge committed
187
        ("cvt", "CVT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
188
        ("data2vec-audio", "DATA2VEC_AUDIO_PRETRAINED_CONFIG_ARCHIVE_MAP"),
189
190
191
192
        ("data2vec-text", "DATA2VEC_TEXT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("data2vec-vision", "DATA2VEC_VISION_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("deberta", "DEBERTA_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("deberta-v2", "DEBERTA_V2_PRETRAINED_CONFIG_ARCHIVE_MAP"),
NielsRogge's avatar
NielsRogge committed
193
        ("deformable_detr", "DEFORMABLE_DETR_PRETRAINED_CONFIG_ARCHIVE_MAP"),
194
195
        ("deit", "DEIT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("detr", "DETR_PRETRAINED_CONFIG_ARCHIVE_MAP"),
196
        ("distilbert", "DISTILBERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
NielsRogge's avatar
NielsRogge committed
197
        ("donut-swin", "DONUT_SWIN_PRETRAINED_CONFIG_ARCHIVE_MAP"),
198
199
200
        ("dpr", "DPR_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("dpt", "DPT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("electra", "ELECTRA_PRETRAINED_CONFIG_ARCHIVE_MAP"),
201
        ("ernie", "ERNIE_PRETRAINED_CONFIG_ARCHIVE_MAP"),
202
        ("esm", "ESM_PRETRAINED_CONFIG_ARCHIVE_MAP"),
203
        ("flaubert", "FLAUBERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
204
205
        ("flava", "FLAVA_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("fnet", "FNET_PRETRAINED_CONFIG_ARCHIVE_MAP"),
206
207
        ("fsmt", "FSMT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("funnel", "FUNNEL_PRETRAINED_CONFIG_ARCHIVE_MAP"),
208
209
210
        ("glpn", "GLPN_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("gpt2", "GPT2_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("gpt_neo", "GPT_NEO_PRETRAINED_CONFIG_ARCHIVE_MAP"),
211
        ("gpt_neox", "GPT_NEOX_PRETRAINED_CONFIG_ARCHIVE_MAP"),
212
        ("gpt_neox_japanese", "GPT_NEOX_JAPANESE_PRETRAINED_CONFIG_ARCHIVE_MAP"),
213
        ("gptj", "GPTJ_PRETRAINED_CONFIG_ARCHIVE_MAP"),
214
        ("groupvit", "GROUPVIT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
215
216
217
        ("hubert", "HUBERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("ibert", "IBERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("imagegpt", "IMAGEGPT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
218
        ("layoutlm", "LAYOUTLM_PRETRAINED_CONFIG_ARCHIVE_MAP"),
219
        ("layoutlmv2", "LAYOUTLMV2_PRETRAINED_CONFIG_ARCHIVE_MAP"),
NielsRogge's avatar
NielsRogge committed
220
        ("layoutlmv3", "LAYOUTLMV3_PRETRAINED_CONFIG_ARCHIVE_MAP"),
221
        ("led", "LED_PRETRAINED_CONFIG_ARCHIVE_MAP"),
222
        ("levit", "LEVIT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
223
        ("longformer", "LONGFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
Daniel Stancl's avatar
Daniel Stancl committed
224
        ("longt5", "LONGT5_PRETRAINED_CONFIG_ARCHIVE_MAP"),
225
226
227
        ("luke", "LUKE_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("lxmert", "LXMERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("m2m_100", "M2M_100_PRETRAINED_CONFIG_ARCHIVE_MAP"),
NielsRogge's avatar
NielsRogge committed
228
        ("markuplm", "MARKUPLM_PRETRAINED_CONFIG_ARCHIVE_MAP"),
229
230
        ("maskformer", "MASKFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("mbart", "MBART_PRETRAINED_CONFIG_ARCHIVE_MAP"),
Chan Woo Kim's avatar
Chan Woo Kim committed
231
        ("mctct", "MCTCT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
232
        ("megatron-bert", "MEGATRON_BERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
233
        ("mobilevit", "MOBILEVIT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
234
        ("mpnet", "MPNET_PRETRAINED_CONFIG_ARCHIVE_MAP"),
StevenTang1998's avatar
StevenTang1998 committed
235
        ("mvp", "MVP_PRETRAINED_CONFIG_ARCHIVE_MAP"),
236
        ("nezha", "NEZHA_PRETRAINED_CONFIG_ARCHIVE_MAP"),
237
238
239
        ("nystromformer", "NYSTROMFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("openai-gpt", "OPENAI_GPT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("opt", "OPT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
240
        ("owlvit", "OWLVIT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
241
        ("pegasus", "PEGASUS_PRETRAINED_CONFIG_ARCHIVE_MAP"),
Jason Phang's avatar
Jason Phang committed
242
        ("pegasus_x", "PEGASUS_X_PRETRAINED_CONFIG_ARCHIVE_MAP"),
243
244
245
246
247
248
249
250
251
252
253
254
255
        ("perceiver", "PERCEIVER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("plbart", "PLBART_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("poolformer", "POOLFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("prophetnet", "PROPHETNET_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("qdqbert", "QDQBERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("realm", "REALM_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("regnet", "REGNET_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("rembert", "REMBERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("resnet", "RESNET_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("retribert", "RETRIBERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("roberta", "ROBERTA_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("roformer", "ROFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("segformer", "SEGFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
256
        ("sew", "SEW_PRETRAINED_CONFIG_ARCHIVE_MAP"),
257
258
259
260
261
262
        ("sew-d", "SEW_D_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("speech_to_text", "SPEECH_TO_TEXT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("speech_to_text_2", "SPEECH_TO_TEXT_2_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("splinter", "SPLINTER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("squeezebert", "SQUEEZEBERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("swin", "SWIN_PRETRAINED_CONFIG_ARCHIVE_MAP"),
263
        ("swinv2", "SWINV2_PRETRAINED_CONFIG_ARCHIVE_MAP"),
264
265
        ("t5", "T5_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("tapas", "TAPAS_PRETRAINED_CONFIG_ARCHIVE_MAP"),
266
        ("time_series_transformer", "TIME_SERIES_TRANSFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
267
        ("transfo-xl", "TRANSFO_XL_PRETRAINED_CONFIG_ARCHIVE_MAP"),
268
        ("unispeech", "UNISPEECH_PRETRAINED_CONFIG_ARCHIVE_MAP"),
269
270
        ("unispeech-sat", "UNISPEECH_SAT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("van", "VAN_PRETRAINED_CONFIG_ARCHIVE_MAP"),
NielsRogge's avatar
NielsRogge committed
271
        ("videomae", "VIDEOMAE_PRETRAINED_CONFIG_ARCHIVE_MAP"),
272
273
274
275
        ("vilt", "VILT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("visual_bert", "VISUAL_BERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("vit", "VIT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("vit_mae", "VIT_MAE_PRETRAINED_CONFIG_ARCHIVE_MAP"),
276
        ("vit_msn", "VIT_MSN_PRETRAINED_CONFIG_ARCHIVE_MAP"),
277
        ("wav2vec2", "WAV_2_VEC_2_PRETRAINED_CONFIG_ARCHIVE_MAP"),
278
        ("wav2vec2-conformer", "WAV2VEC2_CONFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
NielsRogge's avatar
NielsRogge committed
279
        ("xclip", "X_CLIP_PRETRAINED_CONFIG_ARCHIVE_MAP"),
280
281
282
283
284
285
286
        ("xglm", "XGLM_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("xlm", "XLM_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("xlm-prophetnet", "XLM_PROPHETNET_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("xlm-roberta", "XLM_ROBERTA_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("xlnet", "XLNET_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("yolos", "YOLOS_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("yoso", "YOSO_PRETRAINED_CONFIG_ARCHIVE_MAP"),
287
288
289
290
291
    ]
)

MODEL_NAMES_MAPPING = OrderedDict(
    [
292
        # Add full (and cased) model names here
293
294
295
296
        ("albert", "ALBERT"),
        ("bart", "BART"),
        ("barthez", "BARThez"),
        ("bartpho", "BARTpho"),
NielsRogge's avatar
NielsRogge committed
297
        ("beit", "BEiT"),
298
299
300
        ("bert", "BERT"),
        ("bert-generation", "Bert Generation"),
        ("bert-japanese", "BertJapanese"),
301
        ("bertweet", "BERTweet"),
302
        ("big_bird", "BigBird"),
303
        ("bigbird_pegasus", "BigBird-Pegasus"),
304
305
        ("blenderbot", "Blenderbot"),
        ("blenderbot-small", "BlenderbotSmall"),
Younes Belkada's avatar
Younes Belkada committed
306
        ("bloom", "BLOOM"),
307
308
309
        ("bort", "BORT"),
        ("byt5", "ByT5"),
        ("camembert", "CamemBERT"),
310
        ("canine", "CANINE"),
Suraj Patil's avatar
Suraj Patil committed
311
        ("clip", "CLIP"),
rooa's avatar
rooa committed
312
        ("codegen", "CodeGen"),
313
        ("conditional_detr", "Conditional DETR"),
314
        ("convbert", "ConvBERT"),
315
        ("convnext", "ConvNeXT"),
316
317
        ("cpm", "CPM"),
        ("ctrl", "CTRL"),
NielsRogge's avatar
NielsRogge committed
318
        ("cvt", "CvT"),
319
320
321
322
323
324
        ("data2vec-audio", "Data2VecAudio"),
        ("data2vec-text", "Data2VecText"),
        ("data2vec-vision", "Data2VecVision"),
        ("deberta", "DeBERTa"),
        ("deberta-v2", "DeBERTa-v2"),
        ("decision_transformer", "Decision Transformer"),
NielsRogge's avatar
NielsRogge committed
325
        ("deformable_detr", "Deformable DETR"),
NielsRogge's avatar
NielsRogge committed
326
        ("deit", "DeiT"),
NielsRogge's avatar
NielsRogge committed
327
        ("detr", "DETR"),
328
329
330
        ("dialogpt", "DialoGPT"),
        ("distilbert", "DistilBERT"),
        ("dit", "DiT"),
NielsRogge's avatar
NielsRogge committed
331
332
        ("donut", "Donut"),
        ("donut-swin", "DonutSwin"),
333
334
335
336
        ("dpr", "DPR"),
        ("dpt", "DPT"),
        ("electra", "ELECTRA"),
        ("encoder-decoder", "Encoder decoder"),
337
        ("ernie", "ERNIE"),
338
        ("esm", "ESM"),
339
        ("flaubert", "FlauBERT"),
340
        ("flava", "FLAVA"),
341
342
343
344
345
        ("fnet", "FNet"),
        ("fsmt", "FairSeq Machine-Translation"),
        ("funnel", "Funnel Transformer"),
        ("glpn", "GLPN"),
        ("gpt2", "OpenAI GPT-2"),
Suraj Patil's avatar
Suraj Patil committed
346
        ("gpt_neo", "GPT Neo"),
347
        ("gpt_neox", "GPT NeoX"),
348
        ("gpt_neox_japanese", "GPT NeoX Japanese"),
349
        ("gptj", "GPT-J"),
350
        ("groupvit", "GroupViT"),
351
352
        ("herbert", "HerBERT"),
        ("hubert", "Hubert"),
Sehoon Kim's avatar
Sehoon Kim committed
353
        ("ibert", "I-BERT"),
354
355
356
        ("imagegpt", "ImageGPT"),
        ("layoutlm", "LayoutLM"),
        ("layoutlmv2", "LayoutLMv2"),
NielsRogge's avatar
NielsRogge committed
357
        ("layoutlmv3", "LayoutLMv3"),
358
359
        ("layoutxlm", "LayoutXLM"),
        ("led", "LED"),
360
        ("levit", "LeViT"),
361
        ("longformer", "Longformer"),
Daniel Stancl's avatar
Daniel Stancl committed
362
        ("longt5", "LongT5"),
363
364
365
        ("luke", "LUKE"),
        ("lxmert", "LXMERT"),
        ("m2m_100", "M2M100"),
366
        ("marian", "Marian"),
NielsRogge's avatar
NielsRogge committed
367
        ("markuplm", "MarkupLM"),
368
        ("maskformer", "MaskFormer"),
369
        ("mbart", "mBART"),
370
        ("mbart50", "mBART-50"),
Chan Woo Kim's avatar
Chan Woo Kim committed
371
        ("mctct", "M-CTC-T"),
372
373
        ("megatron-bert", "Megatron-BERT"),
        ("megatron_gpt2", "Megatron-GPT2"),
374
375
        ("mluke", "mLUKE"),
        ("mobilebert", "MobileBERT"),
376
        ("mobilevit", "MobileViT"),
377
        ("mpnet", "MPNet"),
378
        ("mt5", "MT5"),
StevenTang1998's avatar
StevenTang1998 committed
379
        ("mvp", "MVP"),
380
        ("nezha", "Nezha"),
Lysandre Debut's avatar
Lysandre Debut committed
381
        ("nllb", "NLLB"),
382
        ("nystromformer", "Nystr枚mformer"),
383
        ("openai-gpt", "OpenAI GPT"),
Younes Belkada's avatar
Younes Belkada committed
384
        ("opt", "OPT"),
385
        ("owlvit", "OWL-ViT"),
386
        ("pegasus", "Pegasus"),
Jason Phang's avatar
Jason Phang committed
387
        ("pegasus_x", "PEGASUS-X"),
388
389
390
391
392
393
394
        ("perceiver", "Perceiver"),
        ("phobert", "PhoBERT"),
        ("plbart", "PLBart"),
        ("poolformer", "PoolFormer"),
        ("prophetnet", "ProphetNet"),
        ("qdqbert", "QDQBert"),
        ("rag", "RAG"),
395
        ("realm", "REALM"),
396
        ("reformer", "Reformer"),
397
398
399
400
        ("regnet", "RegNet"),
        ("rembert", "RemBERT"),
        ("resnet", "ResNet"),
        ("retribert", "RetriBERT"),
401
        ("roberta", "RoBERTa"),
402
403
404
405
        ("roformer", "RoFormer"),
        ("segformer", "SegFormer"),
        ("sew", "SEW"),
        ("sew-d", "SEW-D"),
406
        ("speech-encoder-decoder", "Speech Encoder decoder"),
407
408
        ("speech_to_text", "Speech2Text"),
        ("speech_to_text_2", "Speech2Text2"),
Ori Ram's avatar
Ori Ram committed
409
        ("splinter", "Splinter"),
410
        ("squeezebert", "SqueezeBERT"),
411
        ("swin", "Swin Transformer"),
412
        ("swinv2", "Swin Transformer V2"),
413
414
415
416
        ("t5", "T5"),
        ("t5v1.1", "T5v1.1"),
        ("tapas", "TAPAS"),
        ("tapex", "TAPEX"),
417
        ("time_series_transformer", "Time Series Transformer"),
Carl's avatar
Carl committed
418
        ("trajectory_transformer", "Trajectory Transformer"),
419
420
        ("transfo-xl", "Transformer-XL"),
        ("trocr", "TrOCR"),
421
        ("ul2", "UL2"),
422
        ("unispeech", "UniSpeech"),
423
424
        ("unispeech-sat", "UniSpeechSat"),
        ("van", "VAN"),
NielsRogge's avatar
NielsRogge committed
425
        ("videomae", "VideoMAE"),
426
427
428
        ("vilt", "ViLT"),
        ("vision-encoder-decoder", "Vision Encoder decoder"),
        ("vision-text-dual-encoder", "VisionTextDualEncoder"),
429
        ("visual_bert", "VisualBERT"),
430
431
        ("vit", "ViT"),
        ("vit_mae", "ViTMAE"),
432
        ("vit_msn", "ViTMSN"),
433
        ("wav2vec2", "Wav2Vec2"),
434
        ("wav2vec2-conformer", "Wav2Vec2-Conformer"),
435
        ("wav2vec2_phoneme", "Wav2Vec2Phoneme"),
Patrick von Platen's avatar
Patrick von Platen committed
436
        ("wavlm", "WavLM"),
NielsRogge's avatar
NielsRogge committed
437
        ("xclip", "X-CLIP"),
438
439
        ("xglm", "XGLM"),
        ("xlm", "XLM"),
440
        ("xlm-prophetnet", "XLM-ProphetNet"),
441
442
443
        ("xlm-roberta", "XLM-RoBERTa"),
        ("xlm-roberta-xl", "XLM-RoBERTa-XL"),
        ("xlnet", "XLNet"),
444
445
        ("xls_r", "XLS-R"),
        ("xlsr_wav2vec2", "XLSR-Wav2Vec2"),
446
447
        ("yolos", "YOLOS"),
        ("yoso", "YOSO"),
448
449
450
    ]
)

451
SPECIAL_MODEL_TYPE_TO_MODULE_NAME = OrderedDict(
452
453
454
455
456
    [
        ("openai-gpt", "openai"),
        ("data2vec-audio", "data2vec"),
        ("data2vec-text", "data2vec"),
        ("data2vec-vision", "data2vec"),
NielsRogge's avatar
NielsRogge committed
457
        ("donut-swin", "donut"),
NielsRogge's avatar
NielsRogge committed
458
        ("xclip", "x_clip"),
459
    ]
460
)
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486


def model_type_to_module_name(key):
    """Converts a config key to the corresponding module."""
    # Special treatment
    if key in SPECIAL_MODEL_TYPE_TO_MODULE_NAME:
        return SPECIAL_MODEL_TYPE_TO_MODULE_NAME[key]

    return key.replace("-", "_")


def config_class_to_model_type(config):
    """Converts a config class name to the corresponding model type"""
    for key, cls in CONFIG_MAPPING_NAMES.items():
        if cls == config:
            return key
    return None


class _LazyConfigMapping(OrderedDict):
    """
    A dictionary that lazily load its values when they are requested.
    """

    def __init__(self, mapping):
        self._mapping = mapping
487
        self._extra_content = {}
488
489
490
        self._modules = {}

    def __getitem__(self, key):
491
492
        if key in self._extra_content:
            return self._extra_content[key]
493
494
495
496
497
498
        if key not in self._mapping:
            raise KeyError(key)
        value = self._mapping[key]
        module_name = model_type_to_module_name(key)
        if module_name not in self._modules:
            self._modules[module_name] = importlib.import_module(f".{module_name}", "transformers.models")
499
500
501
502
503
504
505
        if hasattr(self._modules[module_name], value):
            return getattr(self._modules[module_name], value)

        # Some of the mappings have entries model_type -> config of another model type. In that case we try to grab the
        # object at the top level.
        transformers_module = importlib.import_module("transformers")
        return getattr(transformers_module, value)
506
507

    def keys(self):
508
        return list(self._mapping.keys()) + list(self._extra_content.keys())
509
510

    def values(self):
511
        return [self[k] for k in self._mapping.keys()] + list(self._extra_content.values())
512

513
    def items(self):
514
        return [(k, self[k]) for k in self._mapping.keys()] + list(self._extra_content.items())
515
516

    def __iter__(self):
517
        return iter(list(self._mapping.keys()) + list(self._extra_content.keys()))
518
519

    def __contains__(self, item):
520
521
522
523
524
525
526
527
528
        return item in self._mapping or item in self._extra_content

    def register(self, key, value):
        """
        Register a new configuration in this mapping.
        """
        if key in self._mapping.keys():
            raise ValueError(f"'{key}' is already used by a Transformers config, pick another name.")
        self._extra_content[key] = value
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593


CONFIG_MAPPING = _LazyConfigMapping(CONFIG_MAPPING_NAMES)


class _LazyLoadAllMappings(OrderedDict):
    """
    A mapping that will load all pairs of key values at the first access (either by indexing, requestions keys, values,
    etc.)

    Args:
        mapping: The mapping to load.
    """

    def __init__(self, mapping):
        self._mapping = mapping
        self._initialized = False
        self._data = {}

    def _initialize(self):
        if self._initialized:
            return
        warnings.warn(
            "ALL_PRETRAINED_CONFIG_ARCHIVE_MAP is deprecated and will be removed in v5 of Transformers. "
            "It does not contain all available model checkpoints, far from it. Checkout hf.co/models for that.",
            FutureWarning,
        )

        for model_type, map_name in self._mapping.items():
            module_name = model_type_to_module_name(model_type)
            module = importlib.import_module(f".{module_name}", "transformers.models")
            mapping = getattr(module, map_name)
            self._data.update(mapping)

        self._initialized = True

    def __getitem__(self, key):
        self._initialize()
        return self._data[key]

    def keys(self):
        self._initialize()
        return self._data.keys()

    def values(self):
        self._initialize()
        return self._data.values()

    def items(self):
        self._initialize()
        return self._data.keys()

    def __iter__(self):
        self._initialize()
        return iter(self._data)

    def __contains__(self, item):
        self._initialize()
        return item in self._data


ALL_PRETRAINED_CONFIG_ARCHIVE_MAP = _LazyLoadAllMappings(CONFIG_ARCHIVE_MAP_MAPPING_NAMES)


def _get_class_name(model_class: Union[str, List[str]]):
594
    if isinstance(model_class, (list, tuple)):
Stas Bekman's avatar
Stas Bekman committed
595
596
        return " or ".join([f"[`{c}`]" for c in model_class if c is not None])
    return f"[`{model_class}`]"
597
598


599
600
601
602
603
def _list_model_options(indent, config_to_class=None, use_model_types=True):
    if config_to_class is None and not use_model_types:
        raise ValueError("Using `use_model_types=False` requires a `config_to_class` dictionary.")
    if use_model_types:
        if config_to_class is None:
Stas Bekman's avatar
Stas Bekman committed
604
            model_type_to_name = {model_type: f"[`{config}`]" for model_type, config in CONFIG_MAPPING_NAMES.items()}
605
606
        else:
            model_type_to_name = {
607
608
609
                model_type: _get_class_name(model_class)
                for model_type, model_class in config_to_class.items()
                if model_type in MODEL_NAMES_MAPPING
610
611
            }
        lines = [
612
            f"{indent}- **{model_type}** -- {model_type_to_name[model_type]} ({MODEL_NAMES_MAPPING[model_type]} model)"
613
            for model_type in sorted(model_type_to_name.keys())
614
615
        ]
    else:
616
617
618
619
620
        config_to_name = {
            CONFIG_MAPPING_NAMES[config]: _get_class_name(clas)
            for config, clas in config_to_class.items()
            if config in CONFIG_MAPPING_NAMES
        }
621
        config_to_model_name = {
622
            config: MODEL_NAMES_MAPPING[model_type] for model_type, config in CONFIG_MAPPING_NAMES.items()
623
624
        }
        lines = [
Sylvain Gugger's avatar
Sylvain Gugger committed
625
626
            f"{indent}- [`{config_name}`] configuration class:"
            f" {config_to_name[config_name]} ({config_to_model_name[config_name]} model)"
627
            for config_name in sorted(config_to_name.keys())
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
        ]
    return "\n".join(lines)


def replace_list_option_in_docstrings(config_to_class=None, use_model_types=True):
    def docstring_decorator(fn):
        docstrings = fn.__doc__
        lines = docstrings.split("\n")
        i = 0
        while i < len(lines) and re.search(r"^(\s*)List options\s*$", lines[i]) is None:
            i += 1
        if i < len(lines):
            indent = re.search(r"^(\s*)List options\s*$", lines[i]).groups()[0]
            if use_model_types:
                indent = f"{indent}    "
            lines[i] = _list_model_options(indent, config_to_class=config_to_class, use_model_types=use_model_types)
            docstrings = "\n".join(lines)
        else:
            raise ValueError(
Sylvain Gugger's avatar
Sylvain Gugger committed
647
648
                f"The function {fn} should have an empty 'List options' in its docstring as placeholder, current"
                f" docstring is:\n{docstrings}"
649
650
651
652
653
654
655
            )
        fn.__doc__ = docstrings
        return fn

    return docstring_decorator


Julien Chaumond's avatar
Julien Chaumond committed
656
class AutoConfig:
Lysandre Debut's avatar
Lysandre Debut committed
657
    r"""
658
    This is a generic configuration class that will be instantiated as one of the configuration classes of the library
659
    when created with the [`~AutoConfig.from_pretrained`] class method.
660

661
    This class cannot be instantiated directly using `__init__()` (throws an error).
662
    """
663

664
    def __init__(self):
665
666
667
668
        raise EnvironmentError(
            "AutoConfig is designed to be instantiated "
            "using the `AutoConfig.from_pretrained(pretrained_model_name_or_path)` method."
        )
669

670
    @classmethod
671
672
673
674
    def for_model(cls, model_type: str, *args, **kwargs):
        if model_type in CONFIG_MAPPING:
            config_class = CONFIG_MAPPING[model_type]
            return config_class(*args, **kwargs)
675
        raise ValueError(
676
            f"Unrecognized model identifier: {model_type}. Should contain one of {', '.join(CONFIG_MAPPING.keys())}"
677
        )
678

679
    @classmethod
680
    @replace_list_option_in_docstrings()
681
    def from_pretrained(cls, pretrained_model_name_or_path, **kwargs):
682
683
        r"""
        Instantiate one of the configuration classes of the library from a pretrained model configuration.
684

Sylvain Gugger's avatar
Sylvain Gugger committed
685
686
        The configuration class to instantiate is selected based on the `model_type` property of the config object that
        is loaded, or when it's missing, by falling back to using pattern matching on `pretrained_model_name_or_path`:
687

688
        List options
Lysandre Debut's avatar
Lysandre Debut committed
689
690

        Args:
691
            pretrained_model_name_or_path (`str` or `os.PathLike`):
692
693
                Can be either:

694
695
696
697
                    - A string, the *model id* of a pretrained model configuration hosted inside a model repo on
                      huggingface.co. Valid model ids can be located at the root-level, like `bert-base-uncased`, or
                      namespaced under a user or organization name, like `dbmdz/bert-base-german-cased`.
                    - A path to a *directory* containing a configuration file saved using the
Sylvain Gugger's avatar
Sylvain Gugger committed
698
699
                      [`~PretrainedConfig.save_pretrained`] method, or the [`~PreTrainedModel.save_pretrained`] method,
                      e.g., `./my_model_directory/`.
700
701
702
                    - A path or url to a saved configuration JSON *file*, e.g.,
                      `./my_model_directory/configuration.json`.
            cache_dir (`str` or `os.PathLike`, *optional*):
703
704
                Path to a directory in which a downloaded pretrained model configuration should be cached if the
                standard cache should not be used.
705
            force_download (`bool`, *optional*, defaults to `False`):
706
707
                Whether or not to force the (re-)download the model weights and configuration files and override the
                cached versions if they exist.
708
            resume_download (`bool`, *optional*, defaults to `False`):
709
710
                Whether or not to delete incompletely received files. Will attempt to resume the download if such a
                file exists.
711
            proxies (`Dict[str, str]`, *optional*):
Sylvain Gugger's avatar
Sylvain Gugger committed
712
713
                A dictionary of proxy servers to use by protocol or endpoint, e.g., `{'http': 'foo.bar:3128',
                'http://hostname': 'foo.bar:4012'}`. The proxies are used on each request.
714
            revision (`str`, *optional*, defaults to `"main"`):
Julien Chaumond's avatar
Julien Chaumond committed
715
                The specific model version to use. It can be a branch name, a tag name, or a commit id, since we use a
716
                git-based system for storing models and other artifacts on huggingface.co, so `revision` can be any
Julien Chaumond's avatar
Julien Chaumond committed
717
                identifier allowed by git.
718
719
            return_unused_kwargs (`bool`, *optional*, defaults to `False`):
                If `False`, then this function returns just the final configuration object.
720

Sylvain Gugger's avatar
Sylvain Gugger committed
721
722
723
                If `True`, then this functions returns a `Tuple(config, unused_kwargs)` where *unused_kwargs* is a
                dictionary consisting of the key/value pairs whose keys are not configuration attributes: i.e., the
                part of `kwargs` which has not been used to update `config` and is otherwise ignored.
724
            trust_remote_code (`bool`, *optional*, defaults to `False`):
725
                Whether or not to allow for custom models defined on the Hub in their own modeling files. This option
Sylvain Gugger's avatar
Sylvain Gugger committed
726
727
                should only be set to `True` for repositories you trust and in which you have read the code, as it will
                execute code present on the Hub on your local machine.
728
            kwargs(additional keyword arguments, *optional*):
729
                The values in kwargs of any keys which are configuration attributes will be used to override the loaded
Sylvain Gugger's avatar
Sylvain Gugger committed
730
                values. Behavior concerning key/value pairs whose keys are *not* configuration attributes is controlled
731
                by the `return_unused_kwargs` keyword parameter.
Lysandre Debut's avatar
Lysandre Debut committed
732

733
        Examples:
734

735
736
        ```python
        >>> from transformers import AutoConfig
737

738
        >>> # Download configuration from huggingface.co and cache.
Sylvain Gugger's avatar
Sylvain Gugger committed
739
        >>> config = AutoConfig.from_pretrained("bert-base-uncased")
Lysandre Debut's avatar
Lysandre Debut committed
740

741
        >>> # Download configuration from huggingface.co (user-uploaded) and cache.
Sylvain Gugger's avatar
Sylvain Gugger committed
742
        >>> config = AutoConfig.from_pretrained("dbmdz/bert-base-german-cased")
Lysandre Debut's avatar
Lysandre Debut committed
743

744
        >>> # If configuration file is in a directory (e.g., was saved using *save_pretrained('./test/saved_model/')*).
Sylvain Gugger's avatar
Sylvain Gugger committed
745
        >>> config = AutoConfig.from_pretrained("./test/bert_saved_model/")
746

747
        >>> # Load a specific configuration file.
Sylvain Gugger's avatar
Sylvain Gugger committed
748
        >>> config = AutoConfig.from_pretrained("./test/bert_saved_model/my_configuration.json")
749

750
        >>> # Change some config attributes when loading a pretrained config.
Sylvain Gugger's avatar
Sylvain Gugger committed
751
        >>> config = AutoConfig.from_pretrained("bert-base-uncased", output_attentions=True, foo=False)
752
753
        >>> config.output_attentions
        True
Sylvain Gugger's avatar
Sylvain Gugger committed
754
755
756
757

        >>> config, unused_kwargs = AutoConfig.from_pretrained(
        ...     "bert-base-uncased", output_attentions=True, foo=False, return_unused_kwargs=True
        ... )
758
759
        >>> config.output_attentions
        True
Sylvain Gugger's avatar
Sylvain Gugger committed
760

761
        >>> unused_kwargs
762
763
        {'foo': False}
        ```"""
764
        kwargs["_from_auto"] = True
765
766
        kwargs["name_or_path"] = pretrained_model_name_or_path
        trust_remote_code = kwargs.pop("trust_remote_code", False)
767
        config_dict, unused_kwargs = PretrainedConfig.get_config_dict(pretrained_model_name_or_path, **kwargs)
768
769
770
        if "auto_map" in config_dict and "AutoConfig" in config_dict["auto_map"]:
            if not trust_remote_code:
                raise ValueError(
Sylvain Gugger's avatar
Sylvain Gugger committed
771
772
773
                    f"Loading {pretrained_model_name_or_path} requires you to execute the configuration file in that"
                    " repo on your local machine. Make sure you have read the code there to avoid malicious use, then"
                    " set the option `trust_remote_code=True` to remove this error."
774
775
                )
            if kwargs.get("revision", None) is None:
776
                logger.warning(
777
778
779
780
781
782
783
784
785
786
                    "Explicitly passing a `revision` is encouraged when loading a configuration with custom code to "
                    "ensure no malicious code has been contributed in a newer revision."
                )
            class_ref = config_dict["auto_map"]["AutoConfig"]
            module_file, class_name = class_ref.split(".")
            config_class = get_class_from_dynamic_module(
                pretrained_model_name_or_path, module_file + ".py", class_name, **kwargs
            )
            return config_class.from_pretrained(pretrained_model_name_or_path, **kwargs)
        elif "model_type" in config_dict:
787
            config_class = CONFIG_MAPPING[config_dict["model_type"]]
788
            return config_class.from_dict(config_dict, **unused_kwargs)
789
790
        else:
            # Fallback: use pattern matching on the string.
791
792
            # We go from longer names to shorter names to catch roberta before bert (for instance)
            for pattern in sorted(CONFIG_MAPPING.keys(), key=len, reverse=True):
793
                if pattern in str(pretrained_model_name_or_path):
794
                    return CONFIG_MAPPING[pattern].from_dict(config_dict, **unused_kwargs)
795

796
        raise ValueError(
797
            f"Unrecognized model in {pretrained_model_name_or_path}. "
798
            f"Should have a `model_type` key in its {CONFIG_NAME}, or contain one of the following strings "
799
            f"in its name: {', '.join(CONFIG_MAPPING.keys())}"
800
        )
801
802
803
804
805
806
807

    @staticmethod
    def register(model_type, config):
        """
        Register a new configuration for this class.

        Args:
808
809
            model_type (`str`): The model type like "bert" or "gpt".
            config ([`PretrainedConfig`]): The config to register.
810
811
812
813
814
815
816
817
        """
        if issubclass(config, PretrainedConfig) and config.model_type != model_type:
            raise ValueError(
                "The config you are passing has a `model_type` attribute that is not consistent with the model type "
                f"you passed (config has {config.model_type} and you passed {model_type}. Fix one of those so they "
                "match!"
            )
        CONFIG_MAPPING.register(model_type, config)