{
  "id": "huggingface/model-card-not-found",
  "signature": "HTTPError: 404 Client Error: Not Found for url: https://huggingface.co/api/models/org/nonexistent-model",
  "signature_zh": "HTTPError: 404 客户端错误：未找到 URL：https://huggingface.co/api/models/org/nonexistent-model",
  "regex": "HTTPError: 404 Client Error: Not Found for url: https://huggingface\\.co/api/models/[^/]+/[^/]+",
  "domain": "huggingface",
  "category": "network_error",
  "subcategory": null,
  "root_cause": "The model identifier does not exist on the Hugging Face Hub, either due to a typo, private repository without access, or model deletion.",
  "root_cause_type": "generic",
  "root_cause_zh": "模型标识符在 Hugging Face Hub 上不存在，可能是由于拼写错误、无访问权限的私有仓库或模型被删除。",
  "versions": [
    {
      "version": "huggingface-hub>=0.11.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "transformers>=4.20.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "Adding `--use_auth_token` or `token=True` without a valid token",
      "why_fails": "If the model does not exist at all, authentication does not help; 404 persists.",
      "fail_rate": 0.8,
      "condition": "",
      "sources": []
    },
    {
      "action": "Checking the model page manually but not correcting the identifier in code",
      "why_fails": "The code still uses the wrong identifier; manual verification does not fix the programmatic call.",
      "fail_rate": 0.9,
      "condition": "",
      "sources": []
    },
    {
      "action": "Clearing the cache and retrying",
      "why_fails": "The error is a server-side 404, not a cache issue; clearing cache has no effect.",
      "fail_rate": 0.7,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Verify the exact model identifier on the Hugging Face Hub and correct it: `model_id = 'bert-base-uncased'  # correct identifier`",
      "success_rate": 0.95,
      "how": "Verify the exact model identifier on the Hugging Face Hub and correct it: `model_id = 'bert-base-uncased'  # correct identifier`",
      "condition": "",
      "sources": []
    },
    {
      "action": "If the model is private, log in with `huggingface-cli login` and use `token=True` in `from_pretrained()`: `model = AutoModel.from_pretrained('org/private-model', token=True)`",
      "success_rate": 0.9,
      "how": "If the model is private, log in with `huggingface-cli login` and use `token=True` in `from_pretrained()`: `model = AutoModel.from_pretrained('org/private-model', token=True)`",
      "condition": "",
      "sources": []
    },
    {
      "action": "Search for the model using the Hub API: `import requests; r = requests.get('https://huggingface.co/api/models?search=bert'); r.json()` to find valid identifiers.",
      "success_rate": 0.85,
      "how": "Search for the model using the Hub API: `import requests; r = requests.get('https://huggingface.co/api/models?search=bert'); r.json()` to find valid identifiers.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "Verify the exact model identifier on the Hugging Face Hub and correct it: `model_id = 'bert-base-uncased'  # correct identifier`",
    "If the model is private, log in with `huggingface-cli login` and use `token=True` in `from_pretrained()`: `model = AutoModel.from_pretrained('org/private-model', token=True)`",
    "Search for the model using the Hub API: `import requests; r = requests.get('https://huggingface.co/api/models?search=bert'); r.json()` to find valid identifiers."
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://huggingface.co/docs/hub/en/models-identifiers",
  "official_doc_section": null,
  "error_code": "404",
  "verification_tier": "ai_generated",
  "confidence": 0.9,
  "fix_success_rate": 0.95,
  "resolvable": "true",
  "first_seen": "2023-01-05",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}