registry.py 24.6 KB
Newer Older
1
# SPDX-License-Identifier: Apache-2.0
2
3
4
5
"""
Whenever you add an architecture to this page, please also update
`tests/models/registry.py` with example HuggingFace models for it.
"""
6
import importlib
7
import os
8
import pickle
9
10
import subprocess
import sys
11
import tempfile
12
13
14
from abc import ABC, abstractmethod
from dataclasses import dataclass, field
from functools import lru_cache
15
16
from typing import (AbstractSet, Callable, Dict, List, Optional, Tuple, Type,
                    TypeVar, Union)
17

18
import cloudpickle
19
20
21
22
import torch.nn as nn

from vllm.logger import init_logger

23
24
25
26
from .interfaces import (has_inner_state, has_noops, is_attention_free,
                         is_hybrid, supports_cross_encoding,
                         supports_multimodal, supports_pp,
                         supports_transcription, supports_v0_only)
27
from .interfaces_base import is_text_generation_model
28
29
30

logger = init_logger(__name__)

31
# yapf: disable
32
33
_TEXT_GENERATION_MODELS = {
    # [Decoder-only]
34
35
36
    "AquilaModel": ("llama", "LlamaForCausalLM"),
    "AquilaForCausalLM": ("llama", "LlamaForCausalLM"),  # AquilaChat2
    "ArcticForCausalLM": ("arctic", "ArcticForCausalLM"),
37
    "MiniMaxText01ForCausalLM": ("minimax_text_01", "MiniMaxText01ForCausalLM"),
38
39
40
41
    # baichuan-7b, upper case 'C' in the class name
    "BaiChuanForCausalLM": ("baichuan", "BaiChuanForCausalLM"),
    # baichuan-13b, lower case 'c' in the class name
    "BaichuanForCausalLM": ("baichuan", "BaichuanForCausalLM"),
Yu Chin Fabian Lim's avatar
Yu Chin Fabian Lim committed
42
    "BambaForCausalLM": ("bamba", "BambaForCausalLM"),
43
    "BloomForCausalLM": ("bloom", "BloomForCausalLM"),
44
    "ChatGLMModel": ("chatglm", "ChatGLMForCausalLM"),
45
    "ChatGLMForConditionalGeneration": ("chatglm", "ChatGLMForCausalLM"),
46
    "CohereForCausalLM": ("commandr", "CohereForCausalLM"),
47
    "Cohere2ForCausalLM": ("commandr", "CohereForCausalLM"),
48
    "DbrxForCausalLM": ("dbrx", "DbrxForCausalLM"),
49
    "DeciLMForCausalLM": ("nemotron_nas", "DeciLMForCausalLM"),
50
51
    "DeepseekForCausalLM": ("deepseek", "DeepseekForCausalLM"),
    "DeepseekV2ForCausalLM": ("deepseek_v2", "DeepseekV2ForCausalLM"),
52
    "DeepseekV3ForCausalLM": ("deepseek_v2", "DeepseekV3ForCausalLM"),
53
54
    "ExaoneForCausalLM": ("exaone", "ExaoneForCausalLM"),
    "FalconForCausalLM": ("falcon", "FalconForCausalLM"),
55
    "Fairseq2LlamaForCausalLM": ("fairseq2_llama", "Fairseq2LlamaForCausalLM"),
56
57
    "GemmaForCausalLM": ("gemma", "GemmaForCausalLM"),
    "Gemma2ForCausalLM": ("gemma2", "Gemma2ForCausalLM"),
58
    "Gemma3ForCausalLM": ("gemma3", "Gemma3ForCausalLM"),
59
    "GlmForCausalLM": ("glm", "GlmForCausalLM"),
Yuxuan Zhang's avatar
Yuxuan Zhang committed
60
    "Glm4ForCausalLM": ("glm4", "Glm4ForCausalLM"),
61
62
63
64
65
66
    "GPT2LMHeadModel": ("gpt2", "GPT2LMHeadModel"),
    "GPTBigCodeForCausalLM": ("gpt_bigcode", "GPTBigCodeForCausalLM"),
    "GPTJForCausalLM": ("gpt_j", "GPTJForCausalLM"),
    "GPTNeoXForCausalLM": ("gpt_neox", "GPTNeoXForCausalLM"),
    "GraniteForCausalLM": ("granite", "GraniteForCausalLM"),
    "GraniteMoeForCausalLM": ("granitemoe", "GraniteMoeForCausalLM"),
67
    "GraniteMoeHybridForCausalLM": ("granitemoehybrid", "GraniteMoeHybridForCausalLM"),   # noqa: E501
68
    "GraniteMoeSharedForCausalLM": ("granitemoeshared", "GraniteMoeSharedForCausalLM"),   # noqa: E501
69
    "GritLM": ("gritlm", "GritLM"),
Michael Goin's avatar
Michael Goin committed
70
    "Grok1ModelForCausalLM": ("grok1", "Grok1ForCausalLM"),
71
72
    "InternLMForCausalLM": ("llama", "LlamaForCausalLM"),
    "InternLM2ForCausalLM": ("internlm2", "InternLM2ForCausalLM"),
73
    "InternLM2VEForCausalLM": ("internlm2_ve", "InternLM2VEForCausalLM"),
74
    "InternLM3ForCausalLM": ("llama", "LlamaForCausalLM"),
75
76
77
78
79
    "JAISLMHeadModel": ("jais", "JAISLMHeadModel"),
    "JambaForCausalLM": ("jamba", "JambaForCausalLM"),
    "LlamaForCausalLM": ("llama", "LlamaForCausalLM"),
    # For decapoda-research/llama-*
    "LLaMAForCausalLM": ("llama", "LlamaForCausalLM"),
80
    "MambaForCausalLM": ("mamba", "MambaForCausalLM"),
81
    "FalconMambaForCausalLM": ("mamba", "MambaForCausalLM"),
82
    "Mamba2ForCausalLM": ("mamba2", "Mamba2ForCausalLM"),
83
84
    "MiniCPMForCausalLM": ("minicpm", "MiniCPMForCausalLM"),
    "MiniCPM3ForCausalLM": ("minicpm3", "MiniCPM3ForCausalLM"),
85
86
87
88
89
90
    "MistralForCausalLM": ("llama", "LlamaForCausalLM"),
    "MixtralForCausalLM": ("mixtral", "MixtralForCausalLM"),
    "QuantMixtralForCausalLM": ("mixtral_quant", "MixtralForCausalLM"),
    # transformers's mpt class has lower case
    "MptForCausalLM": ("mpt", "MPTForCausalLM"),
    "MPTForCausalLM": ("mpt", "MPTForCausalLM"),
91
    "MiMoForCausalLM": ("mimo", "MiMoForCausalLM"),
92
93
    "NemotronForCausalLM": ("nemotron", "NemotronForCausalLM"),
    "OlmoForCausalLM": ("olmo", "OlmoForCausalLM"),
94
    "Olmo2ForCausalLM": ("olmo2", "Olmo2ForCausalLM"),
95
96
97
98
99
100
101
102
    "OlmoeForCausalLM": ("olmoe", "OlmoeForCausalLM"),
    "OPTForCausalLM": ("opt", "OPTForCausalLM"),
    "OrionForCausalLM": ("orion", "OrionForCausalLM"),
    "PersimmonForCausalLM": ("persimmon", "PersimmonForCausalLM"),
    "PhiForCausalLM": ("phi", "PhiForCausalLM"),
    "Phi3ForCausalLM": ("phi3", "Phi3ForCausalLM"),
    "Phi3SmallForCausalLM": ("phi3_small", "Phi3SmallForCausalLM"),
    "PhiMoEForCausalLM": ("phimoe", "PhiMoEForCausalLM"),
Shinichi Hemmi's avatar
Shinichi Hemmi committed
103
    "Plamo2ForCausalLM": ("plamo2", "Plamo2ForCausalLM"),
104
    "QWenLMHeadModel": ("qwen", "QWenLMHeadModel"),
105
106
    "Qwen2ForCausalLM": ("qwen2", "Qwen2ForCausalLM"),
    "Qwen2MoeForCausalLM": ("qwen2_moe", "Qwen2MoeForCausalLM"),
107
108
    "Qwen3ForCausalLM": ("qwen3", "Qwen3ForCausalLM"),
    "Qwen3MoeForCausalLM": ("qwen3_moe", "Qwen3MoeForCausalLM"),
109
110
111
112
113
    "RWForCausalLM": ("falcon", "FalconForCausalLM"),
    "StableLMEpochForCausalLM": ("stablelm", "StablelmForCausalLM"),
    "StableLmForCausalLM": ("stablelm", "StablelmForCausalLM"),
    "Starcoder2ForCausalLM": ("starcoder2", "Starcoder2ForCausalLM"),
    "SolarForCausalLM": ("solar", "SolarForCausalLM"),
114
    "TeleChat2ForCausalLM": ("telechat2", "TeleChat2ForCausalLM"),
115
    "TeleFLMForCausalLM": ("teleflm", "TeleFLMForCausalLM"),
116
    "XverseForCausalLM": ("llama", "LlamaForCausalLM"),
117
    "Zamba2ForCausalLM": ("zamba2", "Zamba2ForCausalLM"),
118
119
120
    # [Encoder-decoder]
    "BartModel": ("bart", "BartForConditionalGeneration"),
    "BartForConditionalGeneration": ("bart", "BartForConditionalGeneration"),
121
122
123
}

_EMBEDDING_MODELS = {
124
    # [Text-only]
125
    "BertModel": ("bert", "BertEmbeddingModel"),
126
    "DeciLMForCausalLM": ("nemotron_nas", "DeciLMForCausalLM"),
127
    "Gemma2Model": ("gemma2", "Gemma2ForCausalLM"),
128
    "GlmForCausalLM": ("glm", "GlmForCausalLM"),
129
    "GritLM": ("gritlm", "GritLM"),
130
    "GteModel": ("bert_with_rope", "GteModel"),
131
    "InternLM2ForRewardModel": ("internlm2", "InternLM2ForRewardModel"),
132
    "JambaForSequenceClassification": ("jamba", "JambaForSequenceClassification"),  # noqa: E501
133
    "LlamaModel": ("llama", "LlamaForCausalLM"),
134
135
136
137
138
    **{
        # Multiple models share the same architecture, so we include them all
        k: (mod, arch) for k, (mod, arch) in _TEXT_GENERATION_MODELS.items()
        if arch == "LlamaForCausalLM"
    },
139
    "MistralModel": ("llama", "LlamaForCausalLM"),
140
    "NomicBertModel": ("bert_with_rope", "NomicBertModel"),
141
    "Phi3ForCausalLM": ("phi3", "Phi3ForCausalLM"),
142
143
    "Qwen2Model": ("qwen2", "Qwen2EmbeddingModel"),
    "Qwen2ForCausalLM": ("qwen2", "Qwen2ForCausalLM"),
144
    "Qwen2ForRewardModel": ("qwen2_rm", "Qwen2ForRewardModel"),
145
    "Qwen2ForProcessRewardModel": ("qwen2_rm", "Qwen2ForProcessRewardModel"),
146
147
    "RobertaForMaskedLM": ("roberta", "RobertaEmbeddingModel"),
    "RobertaModel": ("roberta", "RobertaEmbeddingModel"),
148
    "TeleChat2ForCausalLM": ("telechat2", "TeleChat2ForCausalLM"),
149
    "XLMRobertaModel": ("roberta", "RobertaEmbeddingModel"),
150
    # [Multimodal]
Cyrus Leung's avatar
Cyrus Leung committed
151
    "LlavaNextForConditionalGeneration": ("llava_next", "LlavaNextForConditionalGeneration"),  # noqa: E501
152
    "Phi3VForCausalLM": ("phi3v", "Phi3VForCausalLM"),
153
    "Qwen2VLForConditionalGeneration": ("qwen2_vl", "Qwen2VLForConditionalGeneration"),  # noqa: E501
154
155
    # [Auto-converted (see adapters.py)]
    "Qwen2ForSequenceClassification": ("qwen2", "Qwen2ForCausalLM"),
156
157
158
159
    # Technically PrithviGeoSpatialMAE is a model that works on images, both in
    # input and output. I am adding it here because it piggy-backs on embedding
    # models for the time being.
    "PrithviGeoSpatialMAE": ("prithvi_geospatial_mae", "PrithviGeoSpatialMAE"),
160
161
}

162
163
164
165
166
167
_CROSS_ENCODER_MODELS = {
    "BertForSequenceClassification": ("bert", "BertForSequenceClassification"),
    "RobertaForSequenceClassification": ("roberta",
                                         "RobertaForSequenceClassification"),
    "XLMRobertaForSequenceClassification": ("roberta",
                                            "RobertaForSequenceClassification"),
xsank's avatar
xsank committed
168
169
    "ModernBertForSequenceClassification": ("modernbert",
                                            "ModernBertForSequenceClassification"),
170
171
}

172
_MULTIMODAL_MODELS = {
173
    # [Decoder-only]
174
    "AriaForConditionalGeneration": ("aria", "AriaForConditionalGeneration"),
Jennifer Zhao's avatar
Jennifer Zhao committed
175
    "AyaVisionForConditionalGeneration": ("aya_vision", "AyaVisionForConditionalGeneration"),  # noqa: E501
176
177
    "Blip2ForConditionalGeneration": ("blip2", "Blip2ForConditionalGeneration"),
    "ChameleonForConditionalGeneration": ("chameleon", "ChameleonForConditionalGeneration"),  # noqa: E501
178
    "DeepseekVLV2ForCausalLM": ("deepseek_vl2", "DeepseekVLV2ForCausalLM"),
179
    "FuyuForCausalLM": ("fuyu", "FuyuForCausalLM"),
180
    "Gemma3ForConditionalGeneration": ("gemma3_mm", "Gemma3ForConditionalGeneration"),  # noqa: E501
181
    "GLM4VForCausalLM": ("glm4v", "GLM4VForCausalLM"),
182
    "GraniteSpeechForConditionalGeneration": ("granite_speech", "GraniteSpeechForConditionalGeneration"),  # noqa: E501
183
    "H2OVLChatModel": ("h2ovl", "H2OVLChatModel"),
184
    "InternVLChatModel": ("internvl", "InternVLChatModel"),
185
    "Idefics3ForConditionalGeneration":("idefics3","Idefics3ForConditionalGeneration"),
186
    "SmolVLMForConditionalGeneration": ("smolvlm","SmolVLMForConditionalGeneration"),  # noqa: E501
187
    "KimiVLForConditionalGeneration": ("kimi_vl", "KimiVLForConditionalGeneration"),  # noqa: E501
188
189
190
191
    "LlavaForConditionalGeneration": ("llava", "LlavaForConditionalGeneration"),
    "LlavaNextForConditionalGeneration": ("llava_next", "LlavaNextForConditionalGeneration"),  # noqa: E501
    "LlavaNextVideoForConditionalGeneration": ("llava_next_video", "LlavaNextVideoForConditionalGeneration"),  # noqa: E501
    "LlavaOnevisionForConditionalGeneration": ("llava_onevision", "LlavaOnevisionForConditionalGeneration"),  # noqa: E501
192
    "MantisForConditionalGeneration": ("llava", "MantisForConditionalGeneration"),  # noqa: E501
193
    "MiniMaxVL01ForConditionalGeneration": ("minimax_vl_01", "MiniMaxVL01ForConditionalGeneration"),  # noqa: E501
194
    "MiniCPMO": ("minicpmo", "MiniCPMO"),
195
    "MiniCPMV": ("minicpmv", "MiniCPMV"),
196
    "Mistral3ForConditionalGeneration": ("mistral3", "Mistral3ForConditionalGeneration"),  # noqa: E501
197
    "MolmoForCausalLM": ("molmo", "MolmoForCausalLM"),
198
    "NVLM_D": ("nvlm_d", "NVLM_D_Model"),
199
    "Ovis": ("ovis", "Ovis"),
200
    "PaliGemmaForConditionalGeneration": ("paligemma", "PaliGemmaForConditionalGeneration"),  # noqa: E501
201
    "Phi3VForCausalLM": ("phi3v", "Phi3VForCausalLM"),
202
    "PixtralForConditionalGeneration": ("pixtral", "PixtralForConditionalGeneration"),  # noqa: E501
203
    "QwenVLForConditionalGeneration": ("qwen_vl", "QwenVLForConditionalGeneration"),  # noqa: E501
204
    "Qwen2VLForConditionalGeneration": ("qwen2_vl", "Qwen2VLForConditionalGeneration"),  # noqa: E501
Roger Wang's avatar
Roger Wang committed
205
    "Qwen2_5_VLForConditionalGeneration": ("qwen2_5_vl", "Qwen2_5_VLForConditionalGeneration"),  # noqa: E501
206
    "Qwen2AudioForConditionalGeneration": ("qwen2_audio", "Qwen2AudioForConditionalGeneration"),  # noqa: E501
207
    "Qwen2_5OmniModel": ("qwen2_5_omni_thinker", "Qwen2_5OmniThinkerForConditionalGeneration"),  # noqa: E501
208
    "UltravoxModel": ("ultravox", "UltravoxModel"),
209
    "Phi4MMForCausalLM": ("phi4mm", "Phi4MMForCausalLM"),
210
    # [Encoder-decoder]
211
    "Florence2ForConditionalGeneration": ("florence2", "Florence2ForConditionalGeneration"),  # noqa: E501
212
    "MllamaForConditionalGeneration": ("mllama", "MllamaForConditionalGeneration"),  # noqa: E501
213
    "Llama4ForConditionalGeneration": ("mllama4", "Llama4ForConditionalGeneration"),  # noqa: E501
214
    "SkyworkR1VChatModel": ("skyworkr1v", "SkyworkR1VChatModel"),
215
    "WhisperForConditionalGeneration": ("whisper", "WhisperForConditionalGeneration"),  # noqa: E501
216
}
217
218

_SPECULATIVE_DECODING_MODELS = {
219
    "MiMoMTPModel": ("mimo_mtp", "MiMoMTP"),
220
    "EAGLEModel": ("eagle", "EAGLE"),
221
    "EagleLlamaForCausalLM": ("llama_eagle", "EagleLlamaForCausalLM"),
222
    "Eagle3LlamaForCausalLM": ("llama_eagle3", "Eagle3LlamaForCausalLM"),
223
    "DeepSeekMTPModel": ("deepseek_mtp", "DeepSeekMTP"),
224
225
    "MedusaModel": ("medusa", "Medusa"),
    "MLPSpeculatorPreTrainedModel": ("mlp_speculator", "MLPSpeculator"),
226
}
227

228
_TRANSFORMERS_MODELS = {
229
    "TransformersForCausalLM": ("transformers", "TransformersForCausalLM"),
230
}
231
# yapf: enable
232

233
_VLLM_MODELS = {
234
    **_TEXT_GENERATION_MODELS,
235
    **_EMBEDDING_MODELS,
236
    **_CROSS_ENCODER_MODELS,
237
    **_MULTIMODAL_MODELS,
238
    **_SPECULATIVE_DECODING_MODELS,
239
    **_TRANSFORMERS_MODELS,
240
241
}

242
243
244
245
246
247
248
249
# This variable is used as the args for subprocess.run(). We
# can modify  this variable to alter the args if needed. e.g.
# when we use par format to pack things together, sys.executable
# might not be the target we want to run.
_SUBPROCESS_COMMAND = [
    sys.executable, "-m", "vllm.model_executor.models.registry"
]

250

251
252
@dataclass(frozen=True)
class _ModelInfo:
253
    architecture: str
254
    is_text_generation_model: bool
255
    is_pooling_model: bool
256
    supports_cross_encoding: bool
257
258
    supports_multimodal: bool
    supports_pp: bool
259
260
    has_inner_state: bool
    is_attention_free: bool
261
    is_hybrid: bool
262
    has_noops: bool
263
    supports_transcription: bool
264
    supports_v0_only: bool
265
266

    @staticmethod
267
268
    def from_model_cls(model: Type[nn.Module]) -> "_ModelInfo":
        return _ModelInfo(
269
            architecture=model.__name__,
270
            is_text_generation_model=is_text_generation_model(model),
271
            is_pooling_model=True,  # Can convert any model into a pooling model
272
            supports_cross_encoding=supports_cross_encoding(model),
273
274
            supports_multimodal=supports_multimodal(model),
            supports_pp=supports_pp(model),
275
276
            has_inner_state=has_inner_state(model),
            is_attention_free=is_attention_free(model),
277
            is_hybrid=is_hybrid(model),
278
279
            supports_transcription=supports_transcription(model),
            supports_v0_only=supports_v0_only(model),
280
            has_noops=has_noops(model),
281
        )
282
283


284
class _BaseRegisteredModel(ABC):
285

286
287
288
    @abstractmethod
    def inspect_model_cls(self) -> _ModelInfo:
        raise NotImplementedError
289

290
291
292
    @abstractmethod
    def load_model_cls(self) -> Type[nn.Module]:
        raise NotImplementedError
293
294


295
296
297
298
299
300
301
302
@dataclass(frozen=True)
class _RegisteredModel(_BaseRegisteredModel):
    """
    Represents a model that has already been imported in the main process.
    """

    interfaces: _ModelInfo
    model_cls: Type[nn.Module]
303
304

    @staticmethod
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
    def from_model_cls(model_cls: Type[nn.Module]):
        return _RegisteredModel(
            interfaces=_ModelInfo.from_model_cls(model_cls),
            model_cls=model_cls,
        )

    def inspect_model_cls(self) -> _ModelInfo:
        return self.interfaces

    def load_model_cls(self) -> Type[nn.Module]:
        return self.model_cls


@dataclass(frozen=True)
class _LazyRegisteredModel(_BaseRegisteredModel):
    """
    Represents a model that has not been imported in the main process.
    """
    module_name: str
    class_name: str

    # Performed in another process to avoid initializing CUDA
    def inspect_model_cls(self) -> _ModelInfo:
        return _run_in_subprocess(
            lambda: _ModelInfo.from_model_cls(self.load_model_cls()))

    def load_model_cls(self) -> Type[nn.Module]:
        mod = importlib.import_module(self.module_name)
        return getattr(mod, self.class_name)


@lru_cache(maxsize=128)
def _try_load_model_cls(
    model_arch: str,
    model: _BaseRegisteredModel,
) -> Optional[Type[nn.Module]]:
341
    from vllm.platforms import current_platform
342
    current_platform.verify_model_arch(model_arch)
343
344
345
346
347
348
    try:
        return model.load_model_cls()
    except Exception:
        logger.exception("Error in loading model architecture '%s'",
                         model_arch)
        return None
349
350


351
352
353
354
355
356
357
358
359
360
361
@lru_cache(maxsize=128)
def _try_inspect_model_cls(
    model_arch: str,
    model: _BaseRegisteredModel,
) -> Optional[_ModelInfo]:
    try:
        return model.inspect_model_cls()
    except Exception:
        logger.exception("Error in inspecting model architecture '%s'",
                         model_arch)
        return None
362
363


364
365
366
367
@dataclass
class _ModelRegistry:
    # Keyed by model_arch
    models: Dict[str, _BaseRegisteredModel] = field(default_factory=dict)
368

369
370
    def get_supported_archs(self) -> AbstractSet[str]:
        return self.models.keys()
371

372
373
374
375
376
    def register_model(
        self,
        model_arch: str,
        model_cls: Union[Type[nn.Module], str],
    ) -> None:
377
378
379
        """
        Register an external model to be used in vLLM.

380
        `model_cls` can be either:
381

382
383
        - A {class}`torch.nn.Module` class directly referencing the model.
        - A string in the format `<module>:<class>` which can be used to
384
385
          lazily import the model. This is useful to avoid initializing CUDA
          when importing the model and thus the related error
386
          `RuntimeError: Cannot re-initialize CUDA in forked subprocess`.
387
        """
388
389
390
391
        if not isinstance(model_arch, str):
            msg = f"`model_arch` should be a string, not a {type(model_arch)}"
            raise TypeError(msg)

392
        if model_arch in self.models:
393
394
395
            logger.warning(
                "Model architecture %s is already registered, and will be "
                "overwritten by the new model class %s.", model_arch,
396
397
398
399
400
401
402
                model_cls)

        if isinstance(model_cls, str):
            split_str = model_cls.split(":")
            if len(split_str) != 2:
                msg = "Expected a string in the format `<module>:<class>`"
                raise ValueError(msg)
403

404
            model = _LazyRegisteredModel(*split_str)
405
        elif isinstance(model_cls, type) and issubclass(model_cls, nn.Module):
406
            model = _RegisteredModel.from_model_cls(model_cls)
407
408
409
410
        else:
            msg = ("`model_cls` should be a string or PyTorch model class, "
                   f"not a {type(model_arch)}")
            raise TypeError(msg)
411

412
        self.models[model_arch] = model
413

414
415
    def _raise_for_unsupported(self, architectures: List[str]):
        all_supported_archs = self.get_supported_archs()
416

417
418
419
420
421
        if any(arch in all_supported_archs for arch in architectures):
            raise ValueError(
                f"Model architectures {architectures} failed "
                "to be inspected. Please check the logs for more details.")

422
423
424
        raise ValueError(
            f"Model architectures {architectures} are not supported for now. "
            f"Supported architectures: {all_supported_archs}")
425

426
427
428
429
    def _try_load_model_cls(self,
                            model_arch: str) -> Optional[Type[nn.Module]]:
        if model_arch not in self.models:
            return None
430

431
        return _try_load_model_cls(model_arch, self.models[model_arch])
432

433
434
435
    def _try_inspect_model_cls(self, model_arch: str) -> Optional[_ModelInfo]:
        if model_arch not in self.models:
            return None
436

437
        return _try_inspect_model_cls(model_arch, self.models[model_arch])
438

439
440
441
442
    def _normalize_archs(
        self,
        architectures: Union[str, List[str]],
    ) -> List[str]:
443
444
445
446
447
        if isinstance(architectures, str):
            architectures = [architectures]
        if not architectures:
            logger.warning("No model architectures are specified")

448
449
450
451
        # filter out support architectures
        normalized_arch = list(
            filter(lambda model: model in self.models, architectures))

452
        # make sure Transformers backend is put at the last as a fallback
453
        if len(normalized_arch) != len(architectures):
454
            normalized_arch.append("TransformersForCausalLM")
455
        return normalized_arch
456

457
458
459
    def inspect_model_cls(
        self,
        architectures: Union[str, List[str]],
460
    ) -> Tuple[_ModelInfo, str]:
461
        architectures = self._normalize_archs(architectures)
462

463
464
465
        for arch in architectures:
            model_info = self._try_inspect_model_cls(arch)
            if model_info is not None:
466
                return (model_info, arch)
467

468
        return self._raise_for_unsupported(architectures)
469

470
471
472
473
474
    def resolve_model_cls(
        self,
        architectures: Union[str, List[str]],
    ) -> Tuple[Type[nn.Module], str]:
        architectures = self._normalize_archs(architectures)
475

476
477
478
479
        for arch in architectures:
            model_cls = self._try_load_model_cls(arch)
            if model_cls is not None:
                return (model_cls, arch)
480

481
        return self._raise_for_unsupported(architectures)
482

483
484
485
486
    def is_text_generation_model(
        self,
        architectures: Union[str, List[str]],
    ) -> bool:
487
488
        model_cls, _ = self.inspect_model_cls(architectures)
        return model_cls.is_text_generation_model
489

490
    def is_pooling_model(
491
492
493
        self,
        architectures: Union[str, List[str]],
    ) -> bool:
494
        model_cls, _ = self.inspect_model_cls(architectures)
495
        return model_cls.is_pooling_model
496

497
498
499
500
    def is_cross_encoder_model(
        self,
        architectures: Union[str, List[str]],
    ) -> bool:
501
502
        model_cls, _ = self.inspect_model_cls(architectures)
        return model_cls.supports_cross_encoding
503

504
505
506
507
    def is_multimodal_model(
        self,
        architectures: Union[str, List[str]],
    ) -> bool:
508
509
        model_cls, _ = self.inspect_model_cls(architectures)
        return model_cls.supports_multimodal
510
511
512
513
514

    def is_pp_supported_model(
        self,
        architectures: Union[str, List[str]],
    ) -> bool:
515
516
        model_cls, _ = self.inspect_model_cls(architectures)
        return model_cls.supports_pp
517

518
519
520
521
522
523
    def model_has_inner_state(
        self,
        architectures: Union[str, List[str]],
    ) -> bool:
        model_cls, _ = self.inspect_model_cls(architectures)
        return model_cls.has_inner_state
524

525
526
527
528
529
530
    def is_attention_free_model(
        self,
        architectures: Union[str, List[str]],
    ) -> bool:
        model_cls, _ = self.inspect_model_cls(architectures)
        return model_cls.is_attention_free
531

532
533
534
535
536
537
538
    def is_hybrid_model(
        self,
        architectures: Union[str, List[str]],
    ) -> bool:
        model_cls, _ = self.inspect_model_cls(architectures)
        return model_cls.is_hybrid

539
540
541
542
543
544
545
    def is_noops_model(
        self,
        architectures: Union[str, List[str]],
    ) -> bool:
        model_cls, _ = self.inspect_model_cls(architectures)
        return model_cls.has_noops

546
547
548
549
550
551
552
    def is_transcription_model(
        self,
        architectures: Union[str, List[str]],
    ) -> bool:
        model_cls, _ = self.inspect_model_cls(architectures)
        return model_cls.supports_transcription

553
554
555
556
557
558
559
    def is_v1_compatible(
        self,
        architectures: Union[str, List[str]],
    ) -> bool:
        model_cls, _ = self.inspect_model_cls(architectures)
        return not model_cls.supports_v0_only

560
561

ModelRegistry = _ModelRegistry({
562
563
    model_arch:
    _LazyRegisteredModel(
564
565
566
567
568
569
570
571
572
573
        module_name=f"vllm.model_executor.models.{mod_relname}",
        class_name=cls_name,
    )
    for model_arch, (mod_relname, cls_name) in _VLLM_MODELS.items()
})

_T = TypeVar("_T")


def _run_in_subprocess(fn: Callable[[], _T]) -> _T:
574
575
576
577
578
    # NOTE: We use a temporary directory instead of a temporary file to avoid
    # issues like https://stackoverflow.com/questions/23212435/permission-denied-to-write-to-my-temporary-file
    with tempfile.TemporaryDirectory() as tempdir:
        output_filepath = os.path.join(tempdir, "registry_output.tmp")

579
        # `cloudpickle` allows pickling lambda functions directly
580
        input_bytes = cloudpickle.dumps((fn, output_filepath))
581
582
583

        # cannot use `sys.executable __file__` here because the script
        # contains relative imports
584
585
586
        returned = subprocess.run(_SUBPROCESS_COMMAND,
                                  input=input_bytes,
                                  capture_output=True)
587
588
589
590
591
592
593
594
595

        # check if the subprocess is successful
        try:
            returned.check_returncode()
        except Exception as e:
            # wrap raised exception to provide more information
            raise RuntimeError(f"Error raised in subprocess:\n"
                               f"{returned.stderr.decode()}") from e

596
        with open(output_filepath, "rb") as f:
597
598
599
600
601
602
603
604
605
606
607
            return pickle.load(f)


def _run() -> None:
    # Setup plugins
    from vllm.plugins import load_general_plugins
    load_general_plugins()

    fn, output_file = pickle.loads(sys.stdin.buffer.read())

    result = fn()
608
609
610

    with open(output_file, "wb") as f:
        f.write(pickle.dumps(result))
611
612
613


if __name__ == "__main__":
614
    _run()