{
  "id": "llm/ollama-model-not-found-pull-failed",
  "signature": "Error: pull model manifest: file does not exist: /usr/share/ollama/.ollama/models/blobs/sha256-...",
  "signature_zh": "Error: 拉取模型清单：文件不存在：/usr/share/ollama/.ollama/models/blobs/sha256-...",
  "regex": "Error: pull model manifest: file does not exist: .*\\.ollama/models/blobs/sha256-",
  "domain": "llm",
  "category": "install_error",
  "subcategory": null,
  "root_cause": "Ollama model pull fails because a required blob file is missing from the local model cache, often due to incomplete download, disk corruption, or permission issues in the model storage directory.",
  "root_cause_type": "generic",
  "root_cause_zh": "Ollama模型拉取失败，因为本地模型缓存中缺少所需的blob文件，通常是由于下载不完整、磁盘损坏或模型存储目录的权限问题。",
  "versions": [
    {
      "version": "Ollama 0.1.20",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Ollama 0.1.25",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Ollama 0.1.30",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Linux amd64",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "macOS arm64",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "Creates an empty file that fails integrity checks; Ollama will still error on hash verification.",
      "fail_rate": 1.0,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Changes file ownership to root, causing subsequent permission errors for non-root Ollama processes.",
      "fail_rate": 0.5,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Remove the corrupted model and re-pull it cleanly:\n\nollama rm llama2\nrm -rf ~/.ollama/models/blobs/sha256-*\nollama pull llama2",
      "success_rate": 0.9,
      "how": "Remove the corrupted model and re-pull it cleanly:\n\nollama rm llama2\nrm -rf ~/.ollama/models/blobs/sha256-*\nollama pull llama2",
      "condition": "",
      "sources": []
    },
    {
      "action": "Check disk space and permissions, then restart Ollama service before retrying:\n\ndf -h /usr/share/ollama/\nsudo chown -R ollama:ollama /usr/share/ollama/.ollama\nsudo systemctl restart ollama\nollama pull llama2",
      "success_rate": 0.85,
      "how": "Check disk space and permissions, then restart Ollama service before retrying:\n\ndf -h /usr/share/ollama/\nsudo chown -R ollama:ollama /usr/share/ollama/.ollama\nsudo systemctl restart ollama\nollama pull llama2",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "删除损坏的模型并重新拉取：\n\nollama rm llama2\nrm -rf ~/.ollama/models/blobs/sha256-*\nollama pull llama2",
    "检查磁盘空间和权限，然后重启Ollama服务并重试：\n\ndf -h /usr/share/ollama/\nsudo chown -R ollama:ollama /usr/share/ollama/.ollama\nsudo systemctl restart ollama\nollama pull llama2"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://github.com/ollama/ollama/blob/main/docs/faq.md",
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.86,
  "fix_success_rate": 0.88,
  "resolvable": "true",
  "first_seen": "2024-02-01",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}