{"record":{"id":"dcbf2ec74c96bfeb","repo":"hiyouga/LlamaFactory","slug":"lfm2-5-vl-model-requires-transformers-4-58-0-or-i","errorCode":null,"errorMessage":"LFM2.5-VL model requires transformers>=4.58.0 or install from commit: pip install git+https://github.com/huggingface/transformers.git@3c2517727ce28a30f5044e01663ee204deb1cdbe","messagePattern":"LFM2\\.5-VL model requires transformers>=4\\.58\\.0 or install from commit: pip install git\\+https://github\\.com/huggingface/transformers\\.git@3c2517727ce28a30f5044e01663ee204deb1cdbe","errorType":"exception","errorClass":"RuntimeError","httpStatus":null,"severity":"error","filePath":"src/llamafactory/model/patcher.py","lineNumber":416,"sourceCode":"    # replace the top-k gating method\n    if getattr(config, \"model_type\", None) == \"kimi_vl\" and is_trainable:\n        setattr(config.text_config, \"topk_method\", \"greedy\")\n\n    architectures = getattr(config, \"architectures\", None)\n    if isinstance(architectures, list) and \"InternVLChatModel\" in architectures:\n        raise ValueError(\n            \"Please download the internvl models in a Hugging Face–compatible format \"\n            \"(for example, https://huggingface.co/OpenGVLab/InternVL3-8B-hf).\"\n        )\n\n    if isinstance(architectures, list) and \"LlavaLlamaForCausalLM\" in architectures:\n        raise ValueError(\"Please download llava models with hf-compatible format: https://huggingface.co/llava-hf\")\n\n    if getattr(config, \"model_type\", None) == \"internlm3\" and not is_transformers_version_greater_than(\"4.47.1\"):\n        raise RuntimeError(\"InternLM3 model requires transformers>=4.47.1, please upgrade it.\")\n\n    if getattr(config, \"model_type\", None) == \"lfm2_vl\" and not is_transformers_version_greater_than(\"4.58.0\"):\n        raise RuntimeError(\n            \"LFM2.5-VL model requires transformers>=4.58.0 or install from commit: \"\n            \"pip install git+https://github.com/huggingface/transformers.git@3c2517727ce28a30f5044e01663ee204deb1cdbe\"\n        )\n\n    if getattr(config, \"model_type\", None) == \"moss_vl\":\n        check_version(\"transformers==4.57.1\", mandatory=True)\n        check_version(\"torchcodec==0.7.0\", mandatory=True)\n\n    if getattr(config, \"model_type\", None) == \"qwen3_omni_moe\":\n        patch_qwen3_omni_moe_thinker_text_sparse_moe_block()\n\n    # deepspeed zero3 is not compatible with low_cpu_mem_usage\n    init_kwargs[\"low_cpu_mem_usage\"] = model_args.low_cpu_mem_usage and (not is_deepspeed_zero3_enabled())\n\n    # fsdp/deepspeed zero3 does not need device map\n    if not (is_deepspeed_zero3_enabled() or is_fsdp_enabled()) and init_kwargs[\"low_cpu_mem_usage\"]:\n        if \"device_map\" not in init_kwargs and model_args.device_map:\n            init_kwargs[\"device_map\"] = model_args.device_map  # device map requires low_cpu_mem_usage=True","sourceCodeStart":398,"sourceCodeEnd":434,"githubUrl":"https://github.com/hiyouga/LlamaFactory/blob/f28afaf6355af515454dfb16c97d728307c93897/src/llamafactory/model/patcher.py#L398-L434","documentation":"Error \"LFM2.5-VL model requires transformers>=4.58.0 or install from commit: pip install git+https://github.com/huggingface/transformers.git@3c2517727ce28a30f5044e01663ee204deb1cdbe\" thrown in hiyouga/LlamaFactory.","triggerScenarios":"Thrown at src/llamafactory/model/patcher.py:416 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Upgrade transformers to 4.58.0 or newer: pip install 'transformers>=4.58.0'.","Alternatively install the pinned commit: pip install git+https://github.com/huggingface/transformers.git@3c2517727ce28a30f5044e01663ee204deb1cdbe"],"exampleFix":"pip install 'transformers>=4.58.0'","handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"f28afaf6355af515454dfb16c97d728307c93897","analyzedAt":"2026-08-14T21:57:28.298Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}