{"record":{"id":"b362c4fc727a2b96","repo":"Mintplex-Labs/anything-llm","slug":"an-error-occurred-while-downloading-the-model","errorCode":null,"errorMessage":"An error occurred while downloading the model","messagePattern":"An error occurred while downloading the model","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"frontend/src/components/LLMSelection/DockerModelRunnerOptions/index.jsx","lineNumber":256,"sourceCode":"\n    setFilteredModels(Array.from(filteredModels.values()));\n  }, [searchQuery]);\n\n  async function downloadModel(modelId, fileSize, progressCallback) {\n    try {\n      if (\n        !window.confirm(\n          `Are you sure you want to download this model? It is ${fileSize} in size and may take a while to download.`\n        )\n      )\n        return;\n      const { success, error } = await DMRUtils.downloadModel(\n        modelId,\n        basePath,\n        progressCallback\n      );\n      if (!success)\n        throw new Error(\n          error || \"An error occurred while downloading the model\"\n        );\n      progressCallback(100);\n      handleSetActiveModel(modelId);\n\n      const existingModels = [...customModels];\n      const newModel = existingModels.find((model) => model.id === modelId);\n      if (newModel) {\n        newModel.downloaded = true;\n        setCustomModels(existingModels);\n        setFilteredModels(existingModels);\n        setSearchQuery(\"\");\n      }\n    } catch (e) {\n      console.error(\"Error downloading model:\", e);\n      showToast(\n        e.message || \"An error occurred while downloading the model\",\n        \"error\",","sourceCodeStart":238,"sourceCodeEnd":274,"githubUrl":"https://github.com/Mintplex-Labs/anything-llm/blob/3aec848f2885144aa8f1e53b9731a04310d5d558/frontend/src/components/LLMSelection/DockerModelRunnerOptions/index.jsx#L238-L274","documentation":"Docker Model Runner (DMR) model download UI. After a size confirmation dialog, DMRUtils.downloadModel(modelId, basePath, progressCallback) drives the pull; when it resolves success:false the component throws the util's error text, or this generic fallback when error is empty. The catch shows a toast and the console gets the full error.","triggerScenarios":"Model Runner backend not enabled in Docker Desktop; daemon unreachable or API version mismatch; invalid modelId/basePath; disk space exhausted; registry rate-limited or network blocked mid-pull.","commonSituations":"Model Runner feature not enabled on the Docker Desktop install; unsupported OS/daemon version; low disk on the Docker VM; corporate proxy/VPN blocking the model registry; model id no longer in the registry.","solutions":["Enable/start Model Runner in Docker Desktop settings and confirm `docker model` CLI works, then retry","Inspect the browser console and Docker daemon logs for the underlying pull error","Free disk space and confirm the model's shown file size fits","Retry after verifying the model id still appears in the DMR catalog list"],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":"const dmrOnline = await DMRUtils.pingDaemon?.(); // or GET /_ping on the DMR socket\nif (!dmrOnline) return showToast(\"Start Docker Model Runner first\", \"error\");","typeGuard":null,"tryCatchPattern":"catch (e) {\n  console.error(\"Error downloading model:\", e);\n  showToast(e.message, \"error\", { clear: true });\n  if (/daemon|not running|enable/i.test(e.message)) openDockerSettingsHint();\n}","preventionTips":["Verify Docker Desktop with Model Runner enabled is running before opening the model list","Check disk headroom against the displayed model size before confirming the dialog","Keep the progress callback attached so failures surface mid-stream instead of at the end"],"tags":["docker-model-runner","llm","model-download","frontend"],"backgroundTag":"model-download-failed","analyzedSha":"3aec848f2885144aa8f1e53b9731a04310d5d558","analyzedAt":"2026-08-18T10:02:21.017Z","contentChangedAt":"2026-08-18T10:02:21.017Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}