Build Hugging Face API CLI Scripts

Creates reusable command-line scripts and utilities around the Hugging Face API and the hf CLI tool, designed for chaining, piping, and intermediate processing rather than ad hoc API calls. Every script must accept --help to describe its inputs and outputs, be tested (if non-destructive) before handoff, prefer shell scripts unless Python or TSX is warranted by complexity, and authenticate via the HF_TOKEN environment variable as a bearer token for higher rate limits. It investigates the actual shape of API results before committing to a design, and shares usage examples once a script is complete.

curl -s "https://huggingface.co/.well-known/openapi.json" | jq '.paths | keys | sort'

Sample reference scripts demonstrate the patterns: one chains trending models to metadata to model-card parsing with fallbacks, using HF_TOKEN automatically; one retries a narrowed arXiv-prefixed search when results are too sparse; one uses the hf CLI to download model cards and emit NDJSON summaries (license, pipeline tag, gated-prompt flag); and one reads model IDs from stdin and streams enriched metadata one JSON object per line, composable via piping into jq for sorting and filtering. The full API is documented via OpenAPI at a well-known URL that's too large to read directly, so jq queries extract just the relevant paths - roughly 160 endpoints total, covering /api/datasets, /api/models, /api/spaces, /api/collections, /api/daily_papers, and more.

Use it when you need reusable CLI scripts around the Hugging Face API or hf CLI, shell-friendly utilities supporting chaining and piping, or a composable interface for automating repeated Hub tasks instead of one-off API calls.

Input: a Hugging Face API task needing a reusable script - model or dataset search, metadata enrichment, model-card parsing. Output: a tested CLI script (shell, Python, or TSX) accepting --help, authenticating via HF_TOKEN, and producing shell-pipeable output, typically NDJSON or raw JSON.

Wraps the Hugging Face Hub API (huggingface.co/api/*, documented via .well-known/openapi.json) and the hf CLI, which replaced the deprecated huggingface_hub CLI, with commands for auth, cache, download, endpoints, jobs, repo management, and uploads.

Developers automating repeated Hugging Face Hub tasks who want composable, pipeable CLI tools rather than repeated ad hoc API calls.

Baseline examples ship in three languages - bash, Python, and a TypeScript executable - each an ultra-simple, minimal-logic script emitting raw JSON with the HF_TOKEN header already wired in, meant as a starting point rather than a finished tool.