Document hf models ls --inference-provider / --warm on the Inference Providers Hub API page

[davanstrien]

What

Documents the new hf models ls inference-provider discovery flags (huggingface/huggingface_hub#4497, motivated by huggingface/huggingface_hub#4441: humans and coding agents need a one-command way to find "models I can actually call") in three places:

• hub-api.md (List models): CLI examples alongside the existing curl filters — --warm, --warm --search GLM-5.2, --inference-provider fireworks-ai --sort downloads — plus --expand inferenceProviderMapping / --json pointers.
• guides/first-api-call.md (Step 1): a TIP showing the terminal/agent equivalent of the browser model-search step, so the guide is followable end-to-end without a browser.
• index.md (Inference Playground): a one-sentence terminal pointer next to the Playground option.

All documented commands and variants verified against a git-main install of huggingface_hub.

Why draft

The flags are merged but not yet in a huggingface_hub release (latest is v1.22.0, 2026-07-03). Marking ready once the next release ships so the docs don't point at commands users can't run yet.

🤖 Generated with Claude Code

---

Note

Low Risk
Documentation-only changes with no runtime or API behavior; the only caveat is users may not have the CLI flags until the next huggingface_hub release.

Overview
Documents hf models ls discovery flags (--warm, --inference-provider, --pipeline-tag, --search, --sort, --json, --expand inferenceProviderMapping) as the terminal equivalent of existing Hub API curl filters.

On hub-api.md, a new CLI section sits after the List models curl examples with sample commands and notes on repeating --inference-provider and machine-readable output.

guides/first-api-call.md adds a TIP under Step 1 so model search can be done from the terminal or by agents without the browser.

index.md adds a one-line terminal pointer next to the Inference Playground section, linking to the Hub API page for full filters.

Note: These CLI flags depend on a huggingface_hub release newer than what users may have installed today; the PR description flags that timing.

^{Reviewed by Cursor Bugbot for commit 71df584. Bugbot is set up for automated code reviews on this repo. Configure here.}

[HuggingFaceDocBuilderDev]

The docs for this PR live here. All of your documentation changes will be reflected on that endpoint. The docs are available until 30 days after the last update.

[Wauplin]

Thanks again for taking care of updating the docs 🫶

Feature should be released later today so you'll be good to merge

[davanstrien]

cc @gary149 for viz since you have refreshed the agent onboarding recently.

[davanstrien]

will merge now since the release is imminent. Can iterate if needed