sincecutoff.com
← all changes

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 3
hf spaces search "<natural-language query>" --sdk gradio --description --json --limit 1

WHY 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

Check the installed version and the source before using it. Entry JSON

Report a problem with this card