{"record":{"id":"3d40f3cb242e0332","repo":"hiyouga/LlamaFactory","slug":"please-download-llava-models-with-hf-compatible-fo","errorCode":null,"errorMessage":"Please download llava models with hf-compatible format: https://huggingface.co/llava-hf","messagePattern":"Please download llava models with hf-compatible format: https://huggingface\\.co/llava-hf","errorType":"exception","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"src/llamafactory/model/patcher.py","lineNumber":410,"sourceCode":"            setattr(config, dtype_name, model_args.compute_dtype == dtype)\n\n    if getattr(config, \"model_type\", None) == \"minicpmo\":\n        setattr(config, \"init_audio\", True)\n        setattr(config, \"init_tts\", False)\n\n    # 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","sourceCodeStart":392,"sourceCodeEnd":428,"githubUrl":"https://github.com/hiyouga/LlamaFactory/blob/f28afaf6355af515454dfb16c97d728307c93897/src/llamafactory/model/patcher.py#L392-L428","documentation":"Error \"Please download llava models with hf-compatible format: https://huggingface.co/llava-hf\" thrown in hiyouga/LlamaFactory.","triggerScenarios":"Thrown at src/llamafactory/model/patcher.py:410 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Use an official HF-format LLaVA checkpoint from https://huggingface.co/llava-hf instead of the original LLaVA weights."],"exampleFix":"model_name_or_path: llava-hf/llava-1.5-7b-hf","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"}