configuration_auto.py 39.2 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
        ("albert", "AlbertConfig"),
Jongjyh's avatar
Jongjyh committed
33
        ("altclip", "AltCLIPConfig"),
34
        ("audio-spectrogram-transformer", "ASTConfig"),
35
        ("bart", "BartConfig"),
36
        ("beit", "BeitConfig"),
37
38
39
40
        ("bert", "BertConfig"),
        ("bert-generation", "BertGenerationConfig"),
        ("big_bird", "BigBirdConfig"),
        ("bigbird_pegasus", "BigBirdPegasusConfig"),
Kamal Raj Kanakarajan's avatar
Kamal Raj Kanakarajan committed
41
        ("biogpt", "BioGptConfig"),
NielsRogge's avatar
NielsRogge committed
42
        ("bit", "BitConfig"),
43
44
        ("blenderbot", "BlenderbotConfig"),
        ("blenderbot-small", "BlenderbotSmallConfig"),
Younes Belkada's avatar
Younes Belkada committed
45
        ("blip", "BlipConfig"),
NielsRogge's avatar
NielsRogge committed
46
        ("blip-2", "Blip2Config"),
Younes Belkada's avatar
Younes Belkada committed
47
        ("bloom", "BloomConfig"),
48
        ("bridgetower", "BridgeTowerConfig"),
49
        ("camembert", "CamembertConfig"),
50
        ("canine", "CanineConfig"),
51
        ("chinese_clip", "ChineseCLIPConfig"),
52
        ("clip", "CLIPConfig"),
NielsRogge's avatar
NielsRogge committed
53
        ("clipseg", "CLIPSegConfig"),
rooa's avatar
rooa committed
54
        ("codegen", "CodeGenConfig"),
55
        ("conditional_detr", "ConditionalDetrConfig"),
56
57
58
        ("convbert", "ConvBertConfig"),
        ("convnext", "ConvNextConfig"),
        ("ctrl", "CTRLConfig"),
NielsRogge's avatar
NielsRogge committed
59
        ("cvt", "CvtConfig"),
60
61
62
63
64
65
        ("data2vec-audio", "Data2VecAudioConfig"),
        ("data2vec-text", "Data2VecTextConfig"),
        ("data2vec-vision", "Data2VecVisionConfig"),
        ("deberta", "DebertaConfig"),
        ("deberta-v2", "DebertaV2Config"),
        ("decision_transformer", "DecisionTransformerConfig"),
NielsRogge's avatar
NielsRogge committed
66
        ("deformable_detr", "DeformableDetrConfig"),
67
        ("deit", "DeiTConfig"),
NielsRogge's avatar
NielsRogge committed
68
        ("deta", "DetaConfig"),
69
        ("detr", "DetrConfig"),
70
        ("dinat", "DinatConfig"),
71
        ("distilbert", "DistilBertConfig"),
NielsRogge's avatar
NielsRogge committed
72
        ("donut-swin", "DonutSwinConfig"),
73
74
        ("dpr", "DPRConfig"),
        ("dpt", "DPTConfig"),
75
        ("efficientformer", "EfficientFormerConfig"),
76
77
        ("electra", "ElectraConfig"),
        ("encoder-decoder", "EncoderDecoderConfig"),
78
        ("ernie", "ErnieConfig"),
79
        ("esm", "EsmConfig"),
80
81
82
83
84
        ("flaubert", "FlaubertConfig"),
        ("flava", "FlavaConfig"),
        ("fnet", "FNetConfig"),
        ("fsmt", "FSMTConfig"),
        ("funnel", "FunnelConfig"),
85
        ("git", "GitConfig"),
86
        ("glpn", "GLPNConfig"),
87
        ("gpt-sw3", "GPT2Config"),
88
        ("gpt2", "GPT2Config"),
89
        ("gpt_neo", "GPTNeoConfig"),
90
        ("gpt_neox", "GPTNeoXConfig"),
91
        ("gpt_neox_japanese", "GPTNeoXJapaneseConfig"),
92
        ("gptj", "GPTJConfig"),
93
        ("graphormer", "GraphormerConfig"),
94
        ("groupvit", "GroupViTConfig"),
95
        ("hubert", "HubertConfig"),
96
        ("ibert", "IBertConfig"),
97
        ("imagegpt", "ImageGPTConfig"),
98
        ("jukebox", "JukeboxConfig"),
99
100
        ("layoutlm", "LayoutLMConfig"),
        ("layoutlmv2", "LayoutLMv2Config"),
NielsRogge's avatar
NielsRogge committed
101
        ("layoutlmv3", "LayoutLMv3Config"),
102
        ("led", "LEDConfig"),
103
        ("levit", "LevitConfig"),
NielsRogge's avatar
NielsRogge committed
104
        ("lilt", "LiltConfig"),
105
        ("longformer", "LongformerConfig"),
Daniel Stancl's avatar
Daniel Stancl committed
106
        ("longt5", "LongT5Config"),
107
108
109
        ("luke", "LukeConfig"),
        ("lxmert", "LxmertConfig"),
        ("m2m_100", "M2M100Config"),
110
        ("marian", "MarianConfig"),
NielsRogge's avatar
NielsRogge committed
111
        ("markuplm", "MarkupLMConfig"),
Alara Dirik's avatar
Alara Dirik committed
112
        ("mask2former", "Mask2FormerConfig"),
113
        ("maskformer", "MaskFormerConfig"),
114
        ("maskformer-swin", "MaskFormerSwinConfig"),
115
        ("mbart", "MBartConfig"),
Chan Woo Kim's avatar
Chan Woo Kim committed
116
        ("mctct", "MCTCTConfig"),
117
        ("megatron-bert", "MegatronBertConfig"),
118
        ("mobilebert", "MobileBertConfig"),
119
        ("mobilenet_v1", "MobileNetV1Config"),
120
        ("mobilenet_v2", "MobileNetV2Config"),
121
        ("mobilevit", "MobileViTConfig"),
122
        ("mpnet", "MPNetConfig"),
123
        ("mt5", "MT5Config"),
StevenTang1998's avatar
StevenTang1998 committed
124
        ("mvp", "MvpConfig"),
125
        ("nat", "NatConfig"),
126
        ("nezha", "NezhaConfig"),
127
        ("nystromformer", "NystromformerConfig"),
Jitesh Jain's avatar
Jitesh Jain committed
128
        ("oneformer", "OneFormerConfig"),
129
        ("openai-gpt", "OpenAIGPTConfig"),
Younes Belkada's avatar
Younes Belkada committed
130
        ("opt", "OPTConfig"),
131
        ("owlvit", "OwlViTConfig"),
132
        ("pegasus", "PegasusConfig"),
Jason Phang's avatar
Jason Phang committed
133
        ("pegasus_x", "PegasusXConfig"),
134
135
136
137
138
139
140
        ("perceiver", "PerceiverConfig"),
        ("plbart", "PLBartConfig"),
        ("poolformer", "PoolFormerConfig"),
        ("prophetnet", "ProphetNetConfig"),
        ("qdqbert", "QDQBertConfig"),
        ("rag", "RagConfig"),
        ("realm", "RealmConfig"),
141
        ("reformer", "ReformerConfig"),
142
143
144
145
        ("regnet", "RegNetConfig"),
        ("rembert", "RemBertConfig"),
        ("resnet", "ResNetConfig"),
        ("retribert", "RetriBertConfig"),
146
        ("roberta", "RobertaConfig"),
147
        ("roberta-prelayernorm", "RobertaPreLayerNormConfig"),
Weiwe Shi's avatar
Weiwe Shi committed
148
        ("roc_bert", "RoCBertConfig"),
149
150
151
152
        ("roformer", "RoFormerConfig"),
        ("segformer", "SegformerConfig"),
        ("sew", "SEWConfig"),
        ("sew-d", "SEWDConfig"),
153
        ("speech-encoder-decoder", "SpeechEncoderDecoderConfig"),
154
155
        ("speech_to_text", "Speech2TextConfig"),
        ("speech_to_text_2", "Speech2Text2Config"),
156
        ("speecht5", "SpeechT5Config"),
Ori Ram's avatar
Ori Ram committed
157
        ("splinter", "SplinterConfig"),
158
159
        ("squeezebert", "SqueezeBertConfig"),
        ("swin", "SwinConfig"),
NielsRogge's avatar
NielsRogge committed
160
        ("swin2sr", "Swin2SRConfig"),
161
        ("swinv2", "Swinv2Config"),
162
        ("switch_transformers", "SwitchTransformersConfig"),
163
        ("t5", "T5Config"),
164
        ("table-transformer", "TableTransformerConfig"),
165
        ("tapas", "TapasConfig"),
166
        ("time_series_transformer", "TimeSeriesTransformerConfig"),
167
        ("timesformer", "TimesformerConfig"),
Carl's avatar
Carl committed
168
        ("trajectory_transformer", "TrajectoryTransformerConfig"),
169
170
        ("transfo-xl", "TransfoXLConfig"),
        ("trocr", "TrOCRConfig"),
171
        ("unispeech", "UniSpeechConfig"),
172
        ("unispeech-sat", "UniSpeechSatConfig"),
NielsRogge's avatar
NielsRogge committed
173
        ("upernet", "UperNetConfig"),
174
        ("van", "VanConfig"),
NielsRogge's avatar
NielsRogge committed
175
        ("videomae", "VideoMAEConfig"),
176
177
178
179
180
        ("vilt", "ViltConfig"),
        ("vision-encoder-decoder", "VisionEncoderDecoderConfig"),
        ("vision-text-dual-encoder", "VisionTextDualEncoderConfig"),
        ("visual_bert", "VisualBertConfig"),
        ("vit", "ViTConfig"),
NielsRogge's avatar
NielsRogge committed
181
        ("vit_hybrid", "ViTHybridConfig"),
182
        ("vit_mae", "ViTMAEConfig"),
183
        ("vit_msn", "ViTMSNConfig"),
184
        ("wav2vec2", "Wav2Vec2Config"),
185
        ("wav2vec2-conformer", "Wav2Vec2ConformerConfig"),
Patrick von Platen's avatar
Patrick von Platen committed
186
        ("wavlm", "WavLMConfig"),
187
        ("whisper", "WhisperConfig"),
NielsRogge's avatar
NielsRogge committed
188
        ("xclip", "XCLIPConfig"),
189
190
191
192
193
194
195
196
        ("xglm", "XGLMConfig"),
        ("xlm", "XLMConfig"),
        ("xlm-prophetnet", "XLMProphetNetConfig"),
        ("xlm-roberta", "XLMRobertaConfig"),
        ("xlm-roberta-xl", "XLMRobertaXLConfig"),
        ("xlnet", "XLNetConfig"),
        ("yolos", "YolosConfig"),
        ("yoso", "YosoConfig"),
197
198
    ]
)
199

200
CONFIG_ARCHIVE_MAP_MAPPING_NAMES = OrderedDict(
201
    [
NielsRogge's avatar
NielsRogge committed
202
        # Add archive maps here)
203
        ("albert", "ALBERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
Jongjyh's avatar
Jongjyh committed
204
        ("altclip", "ALTCLIP_PRETRAINED_CONFIG_ARCHIVE_MAP"),
205
        ("audio-spectrogram-transformer", "AUDIO_SPECTROGRAM_TRANSFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
206
        ("bart", "BART_PRETRAINED_CONFIG_ARCHIVE_MAP"),
207
        ("beit", "BEIT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
208
209
210
        ("bert", "BERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("big_bird", "BIG_BIRD_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("bigbird_pegasus", "BIGBIRD_PEGASUS_PRETRAINED_CONFIG_ARCHIVE_MAP"),
Kamal Raj Kanakarajan's avatar
Kamal Raj Kanakarajan committed
211
        ("biogpt", "BIOGPT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
NielsRogge's avatar
NielsRogge committed
212
        ("bit", "BIT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
213
214
        ("blenderbot", "BLENDERBOT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("blenderbot-small", "BLENDERBOT_SMALL_PRETRAINED_CONFIG_ARCHIVE_MAP"),
Younes Belkada's avatar
Younes Belkada committed
215
        ("blip", "BLIP_PRETRAINED_CONFIG_ARCHIVE_MAP"),
NielsRogge's avatar
NielsRogge committed
216
        ("blip-2", "BLIP_2_PRETRAINED_CONFIG_ARCHIVE_MAP"),
Younes Belkada's avatar
Younes Belkada committed
217
        ("bloom", "BLOOM_PRETRAINED_CONFIG_ARCHIVE_MAP"),
218
        ("bridgetower", "BRIDGETOWER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
219
        ("camembert", "CAMEMBERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
220
        ("canine", "CANINE_PRETRAINED_CONFIG_ARCHIVE_MAP"),
221
        ("chinese_clip", "CHINESE_CLIP_PRETRAINED_CONFIG_ARCHIVE_MAP"),
222
        ("clip", "CLIP_PRETRAINED_CONFIG_ARCHIVE_MAP"),
NielsRogge's avatar
NielsRogge committed
223
        ("clipseg", "CLIPSEG_PRETRAINED_CONFIG_ARCHIVE_MAP"),
rooa's avatar
rooa committed
224
        ("codegen", "CODEGEN_PRETRAINED_CONFIG_ARCHIVE_MAP"),
225
        ("conditional_detr", "CONDITIONAL_DETR_PRETRAINED_CONFIG_ARCHIVE_MAP"),
226
        ("convbert", "CONVBERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
227
        ("convnext", "CONVNEXT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
228
        ("ctrl", "CTRL_PRETRAINED_CONFIG_ARCHIVE_MAP"),
NielsRogge's avatar
NielsRogge committed
229
        ("cvt", "CVT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
230
        ("data2vec-audio", "DATA2VEC_AUDIO_PRETRAINED_CONFIG_ARCHIVE_MAP"),
231
232
233
234
        ("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
235
        ("deformable_detr", "DEFORMABLE_DETR_PRETRAINED_CONFIG_ARCHIVE_MAP"),
236
        ("deit", "DEIT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
NielsRogge's avatar
NielsRogge committed
237
        ("deta", "DETA_PRETRAINED_CONFIG_ARCHIVE_MAP"),
238
        ("detr", "DETR_PRETRAINED_CONFIG_ARCHIVE_MAP"),
239
        ("dinat", "DINAT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
240
        ("distilbert", "DISTILBERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
NielsRogge's avatar
NielsRogge committed
241
        ("donut-swin", "DONUT_SWIN_PRETRAINED_CONFIG_ARCHIVE_MAP"),
242
243
        ("dpr", "DPR_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("dpt", "DPT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
244
        ("efficientformer", "EFFICIENTFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
245
        ("electra", "ELECTRA_PRETRAINED_CONFIG_ARCHIVE_MAP"),
246
        ("ernie", "ERNIE_PRETRAINED_CONFIG_ARCHIVE_MAP"),
247
        ("esm", "ESM_PRETRAINED_CONFIG_ARCHIVE_MAP"),
248
        ("flaubert", "FLAUBERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
249
250
        ("flava", "FLAVA_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("fnet", "FNET_PRETRAINED_CONFIG_ARCHIVE_MAP"),
251
252
        ("fsmt", "FSMT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("funnel", "FUNNEL_PRETRAINED_CONFIG_ARCHIVE_MAP"),
253
        ("git", "GIT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
254
255
256
        ("glpn", "GLPN_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("gpt2", "GPT2_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("gpt_neo", "GPT_NEO_PRETRAINED_CONFIG_ARCHIVE_MAP"),
257
        ("gpt_neox", "GPT_NEOX_PRETRAINED_CONFIG_ARCHIVE_MAP"),
258
        ("gpt_neox_japanese", "GPT_NEOX_JAPANESE_PRETRAINED_CONFIG_ARCHIVE_MAP"),
259
        ("gptj", "GPTJ_PRETRAINED_CONFIG_ARCHIVE_MAP"),
260
        ("graphormer", "GRAPHORMER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
261
        ("groupvit", "GROUPVIT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
262
263
264
        ("hubert", "HUBERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("ibert", "IBERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("imagegpt", "IMAGEGPT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
265
        ("jukebox", "JUKEBOX_PRETRAINED_CONFIG_ARCHIVE_MAP"),
266
        ("layoutlm", "LAYOUTLM_PRETRAINED_CONFIG_ARCHIVE_MAP"),
267
        ("layoutlmv2", "LAYOUTLMV2_PRETRAINED_CONFIG_ARCHIVE_MAP"),
NielsRogge's avatar
NielsRogge committed
268
        ("layoutlmv3", "LAYOUTLMV3_PRETRAINED_CONFIG_ARCHIVE_MAP"),
269
        ("led", "LED_PRETRAINED_CONFIG_ARCHIVE_MAP"),
270
        ("levit", "LEVIT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
NielsRogge's avatar
NielsRogge committed
271
        ("lilt", "LILT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
272
        ("longformer", "LONGFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
Daniel Stancl's avatar
Daniel Stancl committed
273
        ("longt5", "LONGT5_PRETRAINED_CONFIG_ARCHIVE_MAP"),
274
275
276
        ("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
277
        ("markuplm", "MARKUPLM_PRETRAINED_CONFIG_ARCHIVE_MAP"),
Alara Dirik's avatar
Alara Dirik committed
278
        ("mask2former", "MASK2FORMER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
279
280
        ("maskformer", "MASKFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("mbart", "MBART_PRETRAINED_CONFIG_ARCHIVE_MAP"),
Chan Woo Kim's avatar
Chan Woo Kim committed
281
        ("mctct", "MCTCT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
282
        ("megatron-bert", "MEGATRON_BERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
283
        ("mobilenet_v1", "MOBILENET_V1_PRETRAINED_CONFIG_ARCHIVE_MAP"),
284
        ("mobilenet_v2", "MOBILENET_V2_PRETRAINED_CONFIG_ARCHIVE_MAP"),
285
        ("mobilevit", "MOBILEVIT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
286
        ("mpnet", "MPNET_PRETRAINED_CONFIG_ARCHIVE_MAP"),
StevenTang1998's avatar
StevenTang1998 committed
287
        ("mvp", "MVP_PRETRAINED_CONFIG_ARCHIVE_MAP"),
288
        ("nat", "NAT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
289
        ("nezha", "NEZHA_PRETRAINED_CONFIG_ARCHIVE_MAP"),
290
        ("nystromformer", "NYSTROMFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
Jitesh Jain's avatar
Jitesh Jain committed
291
        ("oneformer", "ONEFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
292
293
        ("openai-gpt", "OPENAI_GPT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("opt", "OPT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
294
        ("owlvit", "OWLVIT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
295
        ("pegasus", "PEGASUS_PRETRAINED_CONFIG_ARCHIVE_MAP"),
Jason Phang's avatar
Jason Phang committed
296
        ("pegasus_x", "PEGASUS_X_PRETRAINED_CONFIG_ARCHIVE_MAP"),
297
298
299
300
301
302
303
304
305
306
307
        ("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"),
308
        ("roberta-prelayernorm", "ROBERTA_PRELAYERNORM_PRETRAINED_CONFIG_ARCHIVE_MAP"),
Weiwe Shi's avatar
Weiwe Shi committed
309
        ("roc_bert", "ROC_BERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
310
311
        ("roformer", "ROFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("segformer", "SEGFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
312
        ("sew", "SEW_PRETRAINED_CONFIG_ARCHIVE_MAP"),
313
314
315
        ("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"),
316
        ("speecht5", "SPEECHT5_PRETRAINED_CONFIG_ARCHIVE_MAP"),
317
318
319
        ("splinter", "SPLINTER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("squeezebert", "SQUEEZEBERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("swin", "SWIN_PRETRAINED_CONFIG_ARCHIVE_MAP"),
NielsRogge's avatar
NielsRogge committed
320
        ("swin2sr", "SWIN2SR_PRETRAINED_CONFIG_ARCHIVE_MAP"),
321
        ("swinv2", "SWINV2_PRETRAINED_CONFIG_ARCHIVE_MAP"),
322
        ("switch_transformers", "SWITCH_TRANSFORMERS_PRETRAINED_CONFIG_ARCHIVE_MAP"),
323
        ("t5", "T5_PRETRAINED_CONFIG_ARCHIVE_MAP"),
324
        ("table-transformer", "TABLE_TRANSFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
325
        ("tapas", "TAPAS_PRETRAINED_CONFIG_ARCHIVE_MAP"),
326
        ("time_series_transformer", "TIME_SERIES_TRANSFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
327
        ("timesformer", "TIMESFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
328
        ("transfo-xl", "TRANSFO_XL_PRETRAINED_CONFIG_ARCHIVE_MAP"),
329
        ("unispeech", "UNISPEECH_PRETRAINED_CONFIG_ARCHIVE_MAP"),
330
331
        ("unispeech-sat", "UNISPEECH_SAT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("van", "VAN_PRETRAINED_CONFIG_ARCHIVE_MAP"),
NielsRogge's avatar
NielsRogge committed
332
        ("videomae", "VIDEOMAE_PRETRAINED_CONFIG_ARCHIVE_MAP"),
333
334
335
        ("vilt", "VILT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("visual_bert", "VISUAL_BERT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
        ("vit", "VIT_PRETRAINED_CONFIG_ARCHIVE_MAP"),
NielsRogge's avatar
NielsRogge committed
336
        ("vit_hybrid", "VIT_HYBRID_PRETRAINED_CONFIG_ARCHIVE_MAP"),
337
        ("vit_mae", "VIT_MAE_PRETRAINED_CONFIG_ARCHIVE_MAP"),
338
        ("vit_msn", "VIT_MSN_PRETRAINED_CONFIG_ARCHIVE_MAP"),
339
        ("wav2vec2", "WAV_2_VEC_2_PRETRAINED_CONFIG_ARCHIVE_MAP"),
340
        ("wav2vec2-conformer", "WAV2VEC2_CONFORMER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
341
        ("whisper", "WHISPER_PRETRAINED_CONFIG_ARCHIVE_MAP"),
342
        ("xclip", "XCLIP_PRETRAINED_CONFIG_ARCHIVE_MAP"),
343
344
345
346
347
348
349
        ("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"),
350
351
352
353
354
    ]
)

MODEL_NAMES_MAPPING = OrderedDict(
    [
355
        # Add full (and cased) model names here
356
        ("albert", "ALBERT"),
Jongjyh's avatar
Jongjyh committed
357
        ("altclip", "AltCLIP"),
358
        ("audio-spectrogram-transformer", "Audio Spectrogram Transformer"),
359
360
361
        ("bart", "BART"),
        ("barthez", "BARThez"),
        ("bartpho", "BARTpho"),
NielsRogge's avatar
NielsRogge committed
362
        ("beit", "BEiT"),
363
364
365
        ("bert", "BERT"),
        ("bert-generation", "Bert Generation"),
        ("bert-japanese", "BertJapanese"),
366
        ("bertweet", "BERTweet"),
367
        ("big_bird", "BigBird"),
368
        ("bigbird_pegasus", "BigBird-Pegasus"),
Kamal Raj Kanakarajan's avatar
Kamal Raj Kanakarajan committed
369
        ("biogpt", "BioGpt"),
NielsRogge's avatar
NielsRogge committed
370
        ("bit", "BiT"),
371
372
        ("blenderbot", "Blenderbot"),
        ("blenderbot-small", "BlenderbotSmall"),
Younes Belkada's avatar
Younes Belkada committed
373
        ("blip", "BLIP"),
NielsRogge's avatar
NielsRogge committed
374
        ("blip-2", "BLIP-2"),
Younes Belkada's avatar
Younes Belkada committed
375
        ("bloom", "BLOOM"),
376
        ("bort", "BORT"),
377
        ("bridgetower", "BridgeTower"),
378
379
        ("byt5", "ByT5"),
        ("camembert", "CamemBERT"),
380
        ("canine", "CANINE"),
381
        ("chinese_clip", "Chinese-CLIP"),
Suraj Patil's avatar
Suraj Patil committed
382
        ("clip", "CLIP"),
NielsRogge's avatar
NielsRogge committed
383
        ("clipseg", "CLIPSeg"),
rooa's avatar
rooa committed
384
        ("codegen", "CodeGen"),
385
        ("conditional_detr", "Conditional DETR"),
386
        ("convbert", "ConvBERT"),
387
        ("convnext", "ConvNeXT"),
388
389
        ("cpm", "CPM"),
        ("ctrl", "CTRL"),
NielsRogge's avatar
NielsRogge committed
390
        ("cvt", "CvT"),
391
392
393
394
395
396
        ("data2vec-audio", "Data2VecAudio"),
        ("data2vec-text", "Data2VecText"),
        ("data2vec-vision", "Data2VecVision"),
        ("deberta", "DeBERTa"),
        ("deberta-v2", "DeBERTa-v2"),
        ("decision_transformer", "Decision Transformer"),
NielsRogge's avatar
NielsRogge committed
397
        ("deformable_detr", "Deformable DETR"),
NielsRogge's avatar
NielsRogge committed
398
        ("deit", "DeiT"),
NielsRogge's avatar
NielsRogge committed
399
        ("deta", "DETA"),
NielsRogge's avatar
NielsRogge committed
400
        ("detr", "DETR"),
401
        ("dialogpt", "DialoGPT"),
402
        ("dinat", "DiNAT"),
403
404
        ("distilbert", "DistilBERT"),
        ("dit", "DiT"),
NielsRogge's avatar
NielsRogge committed
405
        ("donut-swin", "DonutSwin"),
406
407
        ("dpr", "DPR"),
        ("dpt", "DPT"),
408
        ("efficientformer", "EfficientFormer"),
409
410
        ("electra", "ELECTRA"),
        ("encoder-decoder", "Encoder decoder"),
411
        ("ernie", "ERNIE"),
412
        ("esm", "ESM"),
413
        ("flan-t5", "FLAN-T5"),
414
        ("flaubert", "FlauBERT"),
415
        ("flava", "FLAVA"),
416
417
418
        ("fnet", "FNet"),
        ("fsmt", "FairSeq Machine-Translation"),
        ("funnel", "Funnel Transformer"),
419
        ("git", "GIT"),
420
        ("glpn", "GLPN"),
421
        ("gpt-sw3", "GPT-Sw3"),
422
        ("gpt2", "OpenAI GPT-2"),
Suraj Patil's avatar
Suraj Patil committed
423
        ("gpt_neo", "GPT Neo"),
424
        ("gpt_neox", "GPT NeoX"),
425
        ("gpt_neox_japanese", "GPT NeoX Japanese"),
426
        ("gptj", "GPT-J"),
427
        ("graphormer", "Graphormer"),
428
        ("groupvit", "GroupViT"),
429
430
        ("herbert", "HerBERT"),
        ("hubert", "Hubert"),
Sehoon Kim's avatar
Sehoon Kim committed
431
        ("ibert", "I-BERT"),
432
        ("imagegpt", "ImageGPT"),
433
        ("jukebox", "Jukebox"),
434
435
        ("layoutlm", "LayoutLM"),
        ("layoutlmv2", "LayoutLMv2"),
NielsRogge's avatar
NielsRogge committed
436
        ("layoutlmv3", "LayoutLMv3"),
437
438
        ("layoutxlm", "LayoutXLM"),
        ("led", "LED"),
439
        ("levit", "LeViT"),
NielsRogge's avatar
NielsRogge committed
440
        ("lilt", "LiLT"),
441
        ("longformer", "Longformer"),
Daniel Stancl's avatar
Daniel Stancl committed
442
        ("longt5", "LongT5"),
443
444
445
        ("luke", "LUKE"),
        ("lxmert", "LXMERT"),
        ("m2m_100", "M2M100"),
446
        ("marian", "Marian"),
NielsRogge's avatar
NielsRogge committed
447
        ("markuplm", "MarkupLM"),
Alara Dirik's avatar
Alara Dirik committed
448
        ("mask2former", "Mask2Former"),
449
        ("maskformer", "MaskFormer"),
450
        ("maskformer-swin", "MaskFormerSwin"),
451
        ("mbart", "mBART"),
452
        ("mbart50", "mBART-50"),
Chan Woo Kim's avatar
Chan Woo Kim committed
453
        ("mctct", "M-CTC-T"),
454
455
        ("megatron-bert", "Megatron-BERT"),
        ("megatron_gpt2", "Megatron-GPT2"),
456
457
        ("mluke", "mLUKE"),
        ("mobilebert", "MobileBERT"),
458
        ("mobilenet_v1", "MobileNetV1"),
459
        ("mobilenet_v2", "MobileNetV2"),
460
        ("mobilevit", "MobileViT"),
461
        ("mpnet", "MPNet"),
462
        ("mt5", "MT5"),
StevenTang1998's avatar
StevenTang1998 committed
463
        ("mvp", "MVP"),
464
        ("nat", "NAT"),
465
        ("nezha", "Nezha"),
Lysandre Debut's avatar
Lysandre Debut committed
466
        ("nllb", "NLLB"),
467
        ("nystromformer", "Nystr枚mformer"),
Jitesh Jain's avatar
Jitesh Jain committed
468
        ("oneformer", "OneFormer"),
469
        ("openai-gpt", "OpenAI GPT"),
Younes Belkada's avatar
Younes Belkada committed
470
        ("opt", "OPT"),
471
        ("owlvit", "OWL-ViT"),
472
        ("pegasus", "Pegasus"),
Jason Phang's avatar
Jason Phang committed
473
        ("pegasus_x", "PEGASUS-X"),
474
475
476
477
478
479
480
        ("perceiver", "Perceiver"),
        ("phobert", "PhoBERT"),
        ("plbart", "PLBart"),
        ("poolformer", "PoolFormer"),
        ("prophetnet", "ProphetNet"),
        ("qdqbert", "QDQBert"),
        ("rag", "RAG"),
481
        ("realm", "REALM"),
482
        ("reformer", "Reformer"),
483
484
485
486
        ("regnet", "RegNet"),
        ("rembert", "RemBERT"),
        ("resnet", "ResNet"),
        ("retribert", "RetriBERT"),
487
        ("roberta", "RoBERTa"),
488
        ("roberta-prelayernorm", "RoBERTa-PreLayerNorm"),
Weiwe Shi's avatar
Weiwe Shi committed
489
        ("roc_bert", "RoCBert"),
490
491
492
493
        ("roformer", "RoFormer"),
        ("segformer", "SegFormer"),
        ("sew", "SEW"),
        ("sew-d", "SEW-D"),
494
        ("speech-encoder-decoder", "Speech Encoder decoder"),
495
496
        ("speech_to_text", "Speech2Text"),
        ("speech_to_text_2", "Speech2Text2"),
497
        ("speecht5", "SpeechT5"),
Ori Ram's avatar
Ori Ram committed
498
        ("splinter", "Splinter"),
499
        ("squeezebert", "SqueezeBERT"),
500
        ("swin", "Swin Transformer"),
NielsRogge's avatar
NielsRogge committed
501
        ("swin2sr", "Swin2SR"),
502
        ("swinv2", "Swin Transformer V2"),
503
        ("switch_transformers", "SwitchTransformers"),
504
505
        ("t5", "T5"),
        ("t5v1.1", "T5v1.1"),
506
        ("table-transformer", "Table Transformer"),
507
508
        ("tapas", "TAPAS"),
        ("tapex", "TAPEX"),
509
        ("time_series_transformer", "Time Series Transformer"),
510
        ("timesformer", "TimeSformer"),
Carl's avatar
Carl committed
511
        ("trajectory_transformer", "Trajectory Transformer"),
512
513
        ("transfo-xl", "Transformer-XL"),
        ("trocr", "TrOCR"),
514
        ("ul2", "UL2"),
515
        ("unispeech", "UniSpeech"),
516
        ("unispeech-sat", "UniSpeechSat"),
NielsRogge's avatar
NielsRogge committed
517
        ("upernet", "UPerNet"),
518
        ("van", "VAN"),
NielsRogge's avatar
NielsRogge committed
519
        ("videomae", "VideoMAE"),
520
521
522
        ("vilt", "ViLT"),
        ("vision-encoder-decoder", "Vision Encoder decoder"),
        ("vision-text-dual-encoder", "VisionTextDualEncoder"),
523
        ("visual_bert", "VisualBERT"),
524
        ("vit", "ViT"),
NielsRogge's avatar
NielsRogge committed
525
        ("vit_hybrid", "ViT Hybrid"),
526
        ("vit_mae", "ViTMAE"),
527
        ("vit_msn", "ViTMSN"),
528
        ("wav2vec2", "Wav2Vec2"),
529
        ("wav2vec2-conformer", "Wav2Vec2-Conformer"),
530
        ("wav2vec2_phoneme", "Wav2Vec2Phoneme"),
Patrick von Platen's avatar
Patrick von Platen committed
531
        ("wavlm", "WavLM"),
532
        ("whisper", "Whisper"),
NielsRogge's avatar
NielsRogge committed
533
        ("xclip", "X-CLIP"),
534
535
        ("xglm", "XGLM"),
        ("xlm", "XLM"),
536
        ("xlm-prophetnet", "XLM-ProphetNet"),
537
538
        ("xlm-roberta", "XLM-RoBERTa"),
        ("xlm-roberta-xl", "XLM-RoBERTa-XL"),
539
        ("xlm-v", "XLM-V"),
540
        ("xlnet", "XLNet"),
541
542
        ("xls_r", "XLS-R"),
        ("xlsr_wav2vec2", "XLSR-Wav2Vec2"),
543
544
        ("yolos", "YOLOS"),
        ("yoso", "YOSO"),
545
546
547
    ]
)

548
SPECIAL_MODEL_TYPE_TO_MODULE_NAME = OrderedDict(
549
550
551
552
553
    [
        ("openai-gpt", "openai"),
        ("data2vec-audio", "data2vec"),
        ("data2vec-text", "data2vec"),
        ("data2vec-vision", "data2vec"),
NielsRogge's avatar
NielsRogge committed
554
        ("donut-swin", "donut"),
555
        ("maskformer-swin", "maskformer"),
NielsRogge's avatar
NielsRogge committed
556
        ("xclip", "x_clip"),
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


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
585
        self._extra_content = {}
586
587
588
        self._modules = {}

    def __getitem__(self, key):
589
590
        if key in self._extra_content:
            return self._extra_content[key]
591
592
593
594
595
596
        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")
597
598
599
600
601
602
603
        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)
604
605

    def keys(self):
606
        return list(self._mapping.keys()) + list(self._extra_content.keys())
607
608

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

611
    def items(self):
612
        return [(k, self[k]) for k in self._mapping.keys()] + list(self._extra_content.items())
613
614

    def __iter__(self):
615
        return iter(list(self._mapping.keys()) + list(self._extra_content.keys()))
616
617

    def __contains__(self, item):
618
619
620
621
622
623
624
625
626
        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
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691


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]]):
692
    if isinstance(model_class, (list, tuple)):
Stas Bekman's avatar
Stas Bekman committed
693
694
        return " or ".join([f"[`{c}`]" for c in model_class if c is not None])
    return f"[`{model_class}`]"
695
696


697
698
699
700
701
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
702
            model_type_to_name = {model_type: f"[`{config}`]" for model_type, config in CONFIG_MAPPING_NAMES.items()}
703
704
        else:
            model_type_to_name = {
705
706
707
                model_type: _get_class_name(model_class)
                for model_type, model_class in config_to_class.items()
                if model_type in MODEL_NAMES_MAPPING
708
709
            }
        lines = [
710
            f"{indent}- **{model_type}** -- {model_type_to_name[model_type]} ({MODEL_NAMES_MAPPING[model_type]} model)"
711
            for model_type in sorted(model_type_to_name.keys())
712
713
        ]
    else:
714
715
716
717
718
        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
        }
719
        config_to_model_name = {
720
            config: MODEL_NAMES_MAPPING[model_type] for model_type, config in CONFIG_MAPPING_NAMES.items()
721
722
        }
        lines = [
Sylvain Gugger's avatar
Sylvain Gugger committed
723
724
            f"{indent}- [`{config_name}`] configuration class:"
            f" {config_to_name[config_name]} ({config_to_model_name[config_name]} model)"
725
            for config_name in sorted(config_to_name.keys())
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
        ]
    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
745
746
                f"The function {fn} should have an empty 'List options' in its docstring as placeholder, current"
                f" docstring is:\n{docstrings}"
747
748
749
750
751
752
753
            )
        fn.__doc__ = docstrings
        return fn

    return docstring_decorator


Julien Chaumond's avatar
Julien Chaumond committed
754
class AutoConfig:
Lysandre Debut's avatar
Lysandre Debut committed
755
    r"""
756
    This is a generic configuration class that will be instantiated as one of the configuration classes of the library
757
    when created with the [`~AutoConfig.from_pretrained`] class method.
758

759
    This class cannot be instantiated directly using `__init__()` (throws an error).
760
    """
761

762
    def __init__(self):
763
764
765
766
        raise EnvironmentError(
            "AutoConfig is designed to be instantiated "
            "using the `AutoConfig.from_pretrained(pretrained_model_name_or_path)` method."
        )
767

768
    @classmethod
769
770
771
772
    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)
773
        raise ValueError(
774
            f"Unrecognized model identifier: {model_type}. Should contain one of {', '.join(CONFIG_MAPPING.keys())}"
775
        )
776

777
    @classmethod
778
    @replace_list_option_in_docstrings()
779
    def from_pretrained(cls, pretrained_model_name_or_path, **kwargs):
780
781
        r"""
        Instantiate one of the configuration classes of the library from a pretrained model configuration.
782

Sylvain Gugger's avatar
Sylvain Gugger committed
783
784
        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`:
785

786
        List options
Lysandre Debut's avatar
Lysandre Debut committed
787
788

        Args:
789
            pretrained_model_name_or_path (`str` or `os.PathLike`):
790
791
                Can be either:

792
793
794
795
                    - 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
796
797
                      [`~PretrainedConfig.save_pretrained`] method, or the [`~PreTrainedModel.save_pretrained`] method,
                      e.g., `./my_model_directory/`.
798
799
800
                    - A path or url to a saved configuration JSON *file*, e.g.,
                      `./my_model_directory/configuration.json`.
            cache_dir (`str` or `os.PathLike`, *optional*):
801
802
                Path to a directory in which a downloaded pretrained model configuration should be cached if the
                standard cache should not be used.
803
            force_download (`bool`, *optional*, defaults to `False`):
804
805
                Whether or not to force the (re-)download the model weights and configuration files and override the
                cached versions if they exist.
806
            resume_download (`bool`, *optional*, defaults to `False`):
807
808
                Whether or not to delete incompletely received files. Will attempt to resume the download if such a
                file exists.
809
            proxies (`Dict[str, str]`, *optional*):
Sylvain Gugger's avatar
Sylvain Gugger committed
810
811
                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.
812
            revision (`str`, *optional*, defaults to `"main"`):
Julien Chaumond's avatar
Julien Chaumond committed
813
                The specific model version to use. It can be a branch name, a tag name, or a commit id, since we use a
814
                git-based system for storing models and other artifacts on huggingface.co, so `revision` can be any
Julien Chaumond's avatar
Julien Chaumond committed
815
                identifier allowed by git.
816
817
            return_unused_kwargs (`bool`, *optional*, defaults to `False`):
                If `False`, then this function returns just the final configuration object.
818

Sylvain Gugger's avatar
Sylvain Gugger committed
819
820
821
                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.
822
            trust_remote_code (`bool`, *optional*, defaults to `False`):
823
                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
824
825
                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.
826
            kwargs(additional keyword arguments, *optional*):
827
                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
828
                values. Behavior concerning key/value pairs whose keys are *not* configuration attributes is controlled
829
                by the `return_unused_kwargs` keyword parameter.
Lysandre Debut's avatar
Lysandre Debut committed
830

831
        Examples:
832

833
834
        ```python
        >>> from transformers import AutoConfig
835

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

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

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

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

848
        >>> # Change some config attributes when loading a pretrained config.
Sylvain Gugger's avatar
Sylvain Gugger committed
849
        >>> config = AutoConfig.from_pretrained("bert-base-uncased", output_attentions=True, foo=False)
850
851
        >>> config.output_attentions
        True
Sylvain Gugger's avatar
Sylvain Gugger committed
852
853
854
855

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

859
        >>> unused_kwargs
860
861
        {'foo': False}
        ```"""
862
        kwargs["_from_auto"] = True
863
864
        kwargs["name_or_path"] = pretrained_model_name_or_path
        trust_remote_code = kwargs.pop("trust_remote_code", False)
865
        config_dict, unused_kwargs = PretrainedConfig.get_config_dict(pretrained_model_name_or_path, **kwargs)
866
867
868
        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
869
870
871
                    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."
872
873
                )
            if kwargs.get("revision", None) is None:
874
                logger.warning(
875
876
877
878
879
880
881
882
                    "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
            )
883
            config_class.register_for_auto_class()
884
885
            return config_class.from_pretrained(pretrained_model_name_or_path, **kwargs)
        elif "model_type" in config_dict:
886
            config_class = CONFIG_MAPPING[config_dict["model_type"]]
887
            return config_class.from_dict(config_dict, **unused_kwargs)
888
889
        else:
            # Fallback: use pattern matching on the string.
890
891
            # 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):
892
                if pattern in str(pretrained_model_name_or_path):
893
                    return CONFIG_MAPPING[pattern].from_dict(config_dict, **unused_kwargs)
894

895
        raise ValueError(
896
            f"Unrecognized model in {pretrained_model_name_or_path}. "
897
            f"Should have a `model_type` key in its {CONFIG_NAME}, or contain one of the following strings "
898
            f"in its name: {', '.join(CONFIG_MAPPING.keys())}"
899
        )
900
901
902
903
904
905
906

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

        Args:
907
908
            model_type (`str`): The model type like "bert" or "gpt".
            config ([`PretrainedConfig`]): The config to register.
909
910
911
912
913
914
915
916
        """
        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)