Skip to content

hiveguard datasets

Dataset commands require dashboard credentials (HIVEGUARD_DASHBOARD_TOKEN).

datasets list

Terminal window
hiveguard datasets list
hiveguard datasets list --output json

datasets create

Terminal window
hiveguard datasets create NAME [OPTIONS]
OptionTypeDescription
--modalitystringimage, text, or audio (default: image)
--challenge-typestringDefault challenge type
--promptstringDefault prompt for items

Example:

Terminal window
hiveguard datasets create "ImageNet Cats" --modality image --prompt "Is there a cat?"

datasets show

Terminal window
hiveguard datasets show DATASET_ID

Shows: name, modality, item count, label count, creation date.

datasets delete

Terminal window
hiveguard datasets delete DATASET_ID

Prompts for confirmation. Deletes the dataset and all its items and labels. Cannot be undone.

To skip confirmation in scripts:

Terminal window
echo "y" | hiveguard datasets delete DATASET_ID

datasets export

Stream a dataset’s labels to a file.

Terminal window
hiveguard datasets export DATASET_ID --fmt csv --output labels.csv
hiveguard datasets export DATASET_ID --fmt jsonl --output labels.jsonl
OptionTypeDescription
--fmtstringcsv, json, or jsonl (default: json)
--outputpathOutput file (default: stdout)

The export streams directly from the server — safe for large datasets. A .tmp file is written and renamed atomically on completion. If the stream fails, the partial file is cleaned up.