hiveguard labels

labels list

List all finalized labels.

hiveguard labels list
hiveguard labels list --output jsonl

Requires an API key. All pages are fetched automatically.

Output columns: item_id, data_ref, modality, label, confidence, solver_count.

labels export

Export all labels to a file or stdout.

# Print to stdout (default: json)
hiveguard labels export

# Specific format
hiveguard labels export --fmt jsonl
hiveguard labels export --fmt csv

# Save to file
hiveguard labels export --fmt csv --output labels.csv

Requires an API key. Fetches all pages and formats client-side.

Formats

Format	Description
json	JSON array of label objects
jsonl	One JSON object per line (stream-safe)
csv	Comma-separated, with header row

Output columns

Column	Type	Description
item_id	UUID	Ground-truth item ID
data_ref	string	URL or identifier of the item
modality	string	image, text, or audio
label	string	Consensus answer
confidence	float	Fraction of agreeing solvers (0.0–1.0)
solver_count	int	Number of solvers who answered
created_at	ISO 8601	When label was finalized

Piping

# High-confidence labels only
hiveguard labels export --fmt jsonl | \
  jq -c 'select(.confidence >= 0.9)' > train.jsonl

# Count labels per modality
hiveguard labels export --fmt jsonl | \
  jq -r '.modality' | sort | uniq -c