{
  "slug": "hf-models-ls-filters-by-parameter-count-013a2c23af17",
  "title": "hf models ls filters by parameter count",
  "tools": [
    "hf"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-03-12T17:12:11.000Z",
  "announced_at": "2026-03-12T17:12:11.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When you need Hub models within a parameter-count range, pass that range to `hf models ls --num-parameters`. Use the documented Hub UI range syntax, for example `min:6B,max:128B`.",
    "examples": [
      "hf models ls --num-parameters min:6B,max:128B",
      "models = hf_api.list_models(num_parameters=\"min:6B,max:128B\")"
    ],
    "gotchas": [
      "Version: v1.7.0",
      "--num-parameters TEXT: Filter models by parameter count; accepts the Hub UI range syntax, such as `min:6B,max:128B`.",
      "num_parameters: Filter models by parameter count using the Hub UI range syntax.",
      "The filter uses the Hub UI/API range syntax."
    ]
  },
  "why_it_matters": "Find models in the Hub within a parameter-count range for a repository dependency or evaluation.",
  "sources": [
    "https://github.com/huggingface/huggingface_hub/releases/tag/v1.7.0",
    "https://github.com/huggingface/huggingface_hub/pull/3897",
    "https://huggingface.co/docs/huggingface_hub/v1.7.0/en/package_reference/cli",
    "https://huggingface.co/docs/huggingface_hub/v1.7.0/en/guides/search"
  ],
  "rank": 0.98027,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave2b-20261017",
    "verdict_id": "wave2b-20261017:wave2b-20261017-d8cd378dc59e801b-4:gate",
    "evidence_hash": "d8f0c99dc8443865938251b43e32fcff71fa54510372d19f1825608af46d1d0b"
  },
  "review": {
    "draft_hash": "863620bbe80390853d35616f792a220662141ebbf0a1114b008fd335b09fa76a",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave2b-20261017:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.98 >= 0.9; 2 needed) and Jev gave 0.80 (>= 0.6 needed)."
  }
}