{"record":{"id":"2621f612933fd690","repo":"docling-project/docling","slug":"model-self-vlm-options-repo-id-not-found-in-ar","errorCode":null,"errorMessage":"Model '{self.vlm_options.repo_id}' not found in artifacts_path.\nExpected location: {artifacts_path / repo_cache_folder}\nAvailable models in {artifacts_path}: {', '.join(available_models) if available_models else 'none'}\n\nTo fix this issue:\n  1. Download the model: docling-tools models download-hf-repo {self.vlm_options.repo_id}\n  2. Or remove --artifacts-path to enable auto-download\n  3. Or use a different model that exists in your artifacts_path","messagePattern":"Model '(.+?)' not found in artifacts_path\\.\nExpected location: (.+?)\nAvailable models in (.+?): (.+?)\n\nTo fix this issue:\n  1\\. Download the model: docling-tools models download-hf-repo (.+?)\n  2\\. Or remove --artifacts-path to enable auto-download\n  3\\. Or use a different model that exists in your artifacts_path","errorType":"exception","errorClass":"FileNotFoundError","httpStatus":null,"severity":"error","filePath":"docling/models/vlm_pipeline_models/hf_transformers_model.py","lineNumber":122,"sourceCode":"            self.temperature = vlm_options.temperature\n\n            repo_cache_folder = vlm_options.repo_id.replace(\"/\", \"--\")\n\n            if artifacts_path is None:\n                artifacts_path = self.download_models(\n                    self.vlm_options.repo_id, revision=self.vlm_options.revision\n                )\n            elif (artifacts_path / repo_cache_folder).exists():\n                artifacts_path = artifacts_path / repo_cache_folder\n            else:\n                # Model not found in artifacts_path - raise clear error\n                available_models = []\n                if artifacts_path.exists():\n                    available_models = [\n                        p.name for p in artifacts_path.iterdir() if p.is_dir()\n                    ]\n\n                raise FileNotFoundError(\n                    f\"Model '{self.vlm_options.repo_id}' not found in artifacts_path.\\n\"\n                    f\"Expected location: {artifacts_path / repo_cache_folder}\\n\"\n                    f\"Available models in {artifacts_path}: \"\n                    f\"{', '.join(available_models) if available_models else 'none'}\\n\\n\"\n                    f\"To fix this issue:\\n\"\n                    f\"  1. Download the model: docling-tools models download-hf-repo {self.vlm_options.repo_id}\\n\"\n                    f\"  2. Or remove --artifacts-path to enable auto-download\\n\"\n                    f\"  3. Or use a different model that exists in your artifacts_path\"\n                )\n\n            self.param_quantization_config: BitsAndBytesConfig | None = None\n            if vlm_options.quantized:\n                self.param_quantization_config = BitsAndBytesConfig(\n                    load_in_8bit=vlm_options.load_in_8bit,\n                    llm_int8_threshold=vlm_options.llm_int8_threshold,\n                )\n\n            model_cls: Any = AutoModel","sourceCodeStart":104,"sourceCodeEnd":140,"githubUrl":"https://github.com/docling-project/docling/blob/61d76f1ff3f8428065465889f7b4577da7df704c/docling/models/vlm_pipeline_models/hf_transformers_model.py#L104-L140","documentation":"HuggingFaceTransformersVlmModel resolves the local model directory as artifacts_path/<repo_id with '/' replaced by '--'>. When artifacts_path is given, auto-download is disabled; if that folder does not exist, Docling raises FileNotFoundError listing the expected location, the models actually present, and three remediation options.","triggerScenarios":"Running with --artifacts-path /models for repo_id 'rednote-hilab/dots.mocr' when /models/rednote-hilab--dots.mocr does not exist, or artifacts_path points at an empty/wrong directory.","commonSituations":"CLI users passing --artifacts-path to avoid network access but the model was never fetched; repo_id typos; models directory not mounted into Docker; the '--' flattening convention unknown so the folder is named differently.","solutions":["Download the model into the artifacts path: docling-tools models download-hf-repo <repo_id>","Drop --artifacts-path so Docling auto-downloads from the HF hub","Verify the folder name matches repo_id.replace('/', '--') (e.g. 'rednote-hilab--dots.ocr') or switch repo_id to one of the models listed as available"],"exampleFix":"# before\ndocling --artifacts-path /models -vsm rednote-hilab/dots.mocr file.pdf  # FileNotFoundError\n# after\n# docling-tools models download-hf-repo rednote-hilab/dots.mocr\ndocling --artifacts-path /models -vsm rednote-hilab/dots.mocr file.pdf","handlingStrategy":"validation","validationCode":"from pathlib import Path\n\nexpected = artifacts_path / vlm_options.repo_id.replace('/', '--')\nif artifacts_path is not None and not expected.is_dir():\n    available = [p.name for p in artifacts_path.iterdir() if p.is_dir()]\n    raise FileNotFoundError(f'{expected} missing; have: {available}')","typeGuard":null,"tryCatchPattern":"try:\n    model = HuggingFaceTransformersVlmModel(artifacts_path=artifacts_path, ...)\nexcept FileNotFoundError as e:\n    if 'not found in artifacts_path' in str(e):\n        model = HuggingFaceTransformersVlmModel(artifacts_path=None, ...)  # auto-download\n    else:\n        raise","preventionTips":["Name local model dirs exactly as repo_id with '/' replaced by '--'","Add a preflight check listing artifacts_path contents before conversion","Automate provisioning with docling-tools models download-hf-repo in your setup script"],"tags":["model-download","artifacts-path","file-not-found","cli"],"backgroundTag":null,"analyzedSha":"61d76f1ff3f8428065465889f7b4577da7df704c","analyzedAt":"2026-08-14T23:53:18.727Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}