{"record":{"id":"14920e3c393f2788","repo":"sgl-project/sglang","slug":"no-processor-registered-for-architecture-hf-conf","errorCode":null,"errorMessage":"No processor registered for architecture: {hf_config.architectures}.\nRegistered architectures: {[model_cls.__name__ for model_cls in PROCESSOR_MAPPING.keys()]}","messagePattern":"No processor registered for architecture: (.+?)\\.\nRegistered architectures: (.+?)","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"python/sglang/srt/managers/multimodal_processor.py","lineNumber":84,"sourceCode":"            TransformersAutoMultimodalProcessor,\n        )\n\n        return TransformersAutoMultimodalProcessor\n\n    return None\n\n\ndef get_mm_processor(\n    hf_config,\n    server_args: ServerArgs,\n    processor,\n    transport_mode,\n    model_config=None,\n    **kwargs,\n) -> BaseMultimodalProcessor:\n    processor_cls = get_mm_processor_cls(hf_config, server_args, model_config)\n    if processor_cls is None:\n        raise ValueError(\n            f\"No processor registered for architecture: {hf_config.architectures}.\\n\"\n            f\"Registered architectures: {[model_cls.__name__ for model_cls in PROCESSOR_MAPPING.keys()]}\"\n        )\n    return processor_cls(hf_config, server_args, processor, transport_mode, **kwargs)\n","sourceCodeStart":66,"sourceCodeEnd":89,"githubUrl":"https://github.com/sgl-project/sglang/blob/0132848349585cfe6aae51c4941cbae872505f8a/python/sglang/srt/managers/multimodal_processor.py#L66-L89","documentation":"get_mm_processor looks up the model architecture in PROCESSOR_MAPPING; an architecture with no registered multimodal processor means SGLang has no MM preprocessing pipeline for that model, so serving it (especially with MM inputs or the rust path) fails.","triggerScenarios":"Loading a new/unsupported VLM whose hf_config.architectures entry is absent from PROCESSOR_MAPPING; custom model classes with renamed architectures.","commonSituations":"Newly released VLM on an older SGLang version; community checkpoint with non-standard architecture name; typo in config.json architectures.","solutions":["Upgrade SGLang to a version supporting the architecture","Check PROCESSOR_MAPPING keys and register a processor for your architecture","Fix the model's config.json architectures to match a supported canonical name","Use a supported checkpoint of the same model family"],"exampleFix":null,"handlingStrategy":"fallback","validationCode":"from sglang.srt.managers.multimodal_processor import PROCESSOR_MAPPING\narchs = model_config.hf_config.architectures\nassert any(a in PROCESSOR_MAPPING for a in archs), f'no MM processor for {archs}'","typeGuard":null,"tryCatchPattern":"try:\n    get_mm_processor(...)\nexcept ValueError as e:\n    if 'No processor registered' in str(e):\n        raise SystemExit('upgrade sglang or use a supported checkpoint')\n    raise","preventionTips":["Pin/upgrade SGLang to a release covering your VLM","Verify architectures in config.json before deploying"],"tags":["sglang","multimodal","unsupported-model","version-mismatch"],"backgroundTag":"unsupported-model-architecture","analyzedSha":"0132848349585cfe6aae51c4941cbae872505f8a","analyzedAt":"2026-08-28T05:10:05.995Z","schemaVersion":2},"datasetVersion":"2026-08-28T06:17:29.519Z"}