hf spaces search adds semantic Space discovery
Introduced 2026-04-16 · score 0.99
HOW TO USE IT
When finding Spaces relevant to a repository task, describe the task in a natural-language query to search by what Spaces do. Run `hf spaces search` and add filters or output options as needed.
hf spaces search "<natural-language query>" --limit 3hf spaces search "<natural-language query>" --sdk gradio --description --json --limit 1WHY THIS HELPS
Find Spaces relevant to a repository task by describing what they do.
REQUIREMENTS AND LIMITATIONS
- Version: v1.11.0
- QUERY (required): Natural-language search query describing what the Space does.
- --limit INTEGER: Maximum number of results; documented default is 10.
- --sdk TEXT: Filter results by SDK, such as gradio, docker, or static.
- --description: Show AI-generated descriptions.
- --json: Request JSON output; shown in the v1.11.0 release-note example. The current CLI reference does not list this option.
- Docs conflict: The current CLI reference does not list `--json` under `hf spaces search`, though the v1.11.0 release-note example uses it. The reference may describe a newer version; its documented search options include `--format` only in examples for other commands, not this command.
FIRST-PARTY EVIDENCE
- https://github.com/huggingface/huggingface_hub/releases/tag/v1.11.0
- https://huggingface.co/docs/huggingface_hub/en/package_reference/cli
Check the installed version and the source before using it. Entry JSON