CLI Reference Command-line interface for the Humanbased API.
npm install -g @humanbased/cli
Command Description hb auth set-key <key>Save your API key hb auth whoamiVerify key and show org info
Command Description hb frontiers listList live data sources (online frontiers) hb frontiers list --allInclude historical/offline frontiers hb frontiers tasks <frontier-id>List tasks in a frontier
Command Description hb live pull <sub-id> [--limit N] [--cursor C]Pull submissions with cursor-based pagination hb live adopt <sub-id> <submission-id>Adopt a live submission hb live dispute <sub-id> <submission-id>Dispute a live submission
Command Description hb verticals listList available data verticals hb verticals topics <slug>List topics in a vertical
Command Description hb subscriptions listList deliveries
Command Description hb data pull <sub-id> [--limit N]Pull pending items (default: 50) hb data adopt <item-id>Adopt a data item hb data dispute <item-id>Dispute a data item
Command Description hb billing balanceCheck account balance
# List available frontiers
hb frontiers list
# See tasks in a frontier
hb frontiers tasks 8114254168500106625
# After subscribing in the dashboard, pull data
hb live pull < subscription-i d > --limit 100
# Incremental pull with cursor
hb live pull < subscription-i d > --cursor 123456789
# Review submissions
hb live adopt < subscription-i d > < submission-i d >
hb live dispute < subscription-i d > < submission-i d >
# Browse simulated verticals
hb verticals list
hb verticals topics crypto_account_annotation
# Pull and review
hb data pull < subscription-i d > --limit 50
hb data adopt < item-i d >
Config is stored at ~/.humanbased/config.json:
{
"api_key" : "hb_live_sk_..." ,
"api_url" : "https://api.humanbased.ai"
}
Override the API URL with the HB_API_URL environment variable for local development:
HB_API_URL = http://localhost:8001 hb frontiers list