Hub commands
5 commands. Each entry gives the invocation and an example, in the interface you pick; open the details for parameters, return shape and error codes.
get_dataset
Read one StrataHub dataset card.
strata hub get-dataset
db.hub.get_dataset(name: 'str', *, hub_url: 'Optional[str]' = None) -> 'Any'
Reads `GET /v1/datasets/<name>` from the effective hub URL and returns the dataset card in an executor-owned JSON envelope.
To see the complete help for this command, run:
strata hub get-dataset --helphelp(db.hub.get_dataset)
Example
No CLI example in this release.
card = db.hub.get_dataset("titanic") # doctest: +SKIPcard.primitives, card.license # doctest: +SKIP
info
Read the selected StrataHub's V1 capability advertisement.
strata hub info
db.hub.info(*, hub_url: 'Optional[str]' = None) -> 'Any'
Reads `GET /v1/info` from the effective hub URL resolved by the shared Strata resolver.
To see the complete help for this command, run:
strata hub info --helphelp(db.hub.info)
Example
No CLI example in this release.
db.hub.info().hash_algorithm # doctest: +SKIPlist_datasets
List datasets from the selected StrataHub.
strata hub list-datasets
db.hub.list_datasets(*, tasks: 'Union[str, Iterable[str], None]' = None, tags: 'Union[str, Iterable[str], None]' = None, primitives: 'Union[str, Iterable[str], None]' = None, license: 'Optional[str]' = None, size_min_bytes: 'Optional[int]' = None, size_max_bytes: 'Optional[int]' = None, sort: 'Any' = None, limit: 'Optional[int]' = None, offset: 'Optional[int]' = None, hub_url: 'Optional[str]' = None) -> 'Any'
Reads `GET /v1/datasets` from the effective hub URL. Repeatable task, tag, and primitive filters preserve the StrataHub V1 query shape.
To see the complete help for this command, run:
strata hub list-datasets --helphelp(db.hub.list_datasets)
Example
No CLI example in this release.
page = db.hub.list_datasets(tasks="classification", sort="downloads", limit=5) # doctest: +SKIP[dataset.name for dataset in page.items] # doctest: +SKIP
list_refs
List live refs for a StrataHub dataset.
strata hub list-refs
db.hub.list_refs(dataset: 'str', *, hub_url: 'Optional[str]' = None) -> 'Any'
Reads `GET /v1/datasets/<name>/refs` from the effective hub URL. Yanked refs are filtered by the hub.
To see the complete help for this command, run:
strata hub list-refs --helphelp(db.hub.list_refs)
Example
No CLI example in this release.
[ref.branch for ref in db.hub.list_refs("titanic").refs] # doctest: +SKIPlist_yanked
List yanked refs from the selected StrataHub.
strata hub list-yanked
db.hub.list_yanked(*, since: 'Union[str, datetime, None]' = None, hub_url: 'Optional[str]' = None) -> 'Any'
Reads `GET /v1/yanked` from the effective hub URL. `since`, when supplied, must be an RFC 3339 timestamp.
To see the complete help for this command, run:
strata hub list-yanked --helphelp(db.hub.list_yanked)
Example
No CLI example in this release.
db.hub.list_yanked(since="2026-09-01T00:00:00Z").total # doctest: +SKIP