{
  "id": "huggingface/model-id-not-found-local-or-remote",
  "signature": "OSError: model-org/model-name is not a local folder and is not a valid model identifier listed on 'https://huggingface.co'",
  "signature_zh": "OSError：model-org/model-name 不是本地文件夹，也不是 https://huggingface.co 上列出的有效模型标识符",
  "regex": "OSError: .+ is not a local folder and is not a valid model identifier listed on 'https://huggingface.co'",
  "domain": "huggingface",
  "category": "network_error",
  "subcategory": null,
  "root_cause": "The model identifier does not exist on Hugging Face Hub, or the local path is incorrect, often due to a typo or missing repository.",
  "root_cause_type": "generic",
  "root_cause_zh": "模型标识符在 Hugging Face Hub 上不存在，或本地路径错误，通常是由于拼写错误或仓库缺失。",
  "versions": [
    {
      "version": "huggingface_hub>=0.16.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "transformers>=4.25.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "python>=3.8",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "The model ID should be 'org/name' without protocol, as the library automatically resolves it.",
      "fail_rate": 0.7,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "local_files_only=True prevents any network access, so the model must already be cached locally.",
      "fail_rate": 0.9,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Verify the model ID on Hugging Face Hub: https://huggingface.co/models?search=model-org/model-name. Then use correct ID: model = AutoModel.from_pretrained('correct-org/correct-model')",
      "success_rate": 0.95,
      "how": "Verify the model ID on Hugging Face Hub: https://huggingface.co/models?search=model-org/model-name. Then use correct ID: model = AutoModel.from_pretrained('correct-org/correct-model')",
      "condition": "",
      "sources": []
    },
    {
      "action": "Use from_pretrained with local folder path if model is downloaded manually: model = AutoModel.from_pretrained('./local_model_folder')",
      "success_rate": 0.85,
      "how": "Use from_pretrained with local folder path if model is downloaded manually: model = AutoModel.from_pretrained('./local_model_folder')",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "在 Hugging Face Hub 上验证模型 ID：https://huggingface.co/models?search=model-org/model-name。然后使用正确的 ID：model = AutoModel.from_pretrained('correct-org/correct-model')",
    "如果模型已手动下载，使用本地文件夹路径：model = AutoModel.from_pretrained('./local_model_folder')"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://huggingface.co/docs/hub/en/models",
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.88,
  "fix_success_rate": 0.9,
  "resolvable": "true",
  "first_seen": "2023-09-10",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}