huggingface-hub
The `hf` command is Hugging Face's modern CLI for managing repositories, models, datasets, and Spaces on the Hub. Use it to download and upload files, execute SQL queries against datasets, deploy inference endpoints, manage authentication and repository operations, and sync local directories with cloud buckets.
git clone --depth 1 https://github.com/moltis-org/moltis /tmp/huggingface-hub && cp -r /tmp/huggingface-hub/crates/skills/src/assets/mlops/huggingface-hub ~/.claude/skills/huggingface-hubSKILL.md
# Hugging Face CLI (`hf`) Reference Guide The `hf` command is the modern command-line interface for interacting with the Hugging Face Hub, providing tools to manage repositories, models, datasets, and Spaces. > **IMPORTANT:** The `hf` command replaces the now deprecated `huggingface-cli` command. ## Quick Start * **Installation:** `curl -LsSf https://hf.co/cli/install.sh | bash -s` * **Help:** Use `hf --help` to view all available functions and real-world examples. * **Authentication:** Recommended via `HF_TOKEN` environment variable or the `--token` flag. --- ## Core Commands ### General Operations * `hf download REPO_ID`: Download files from the Hub. * `hf upload REPO_ID`: Upload files/folders (recommended for single-commit). * `hf upload-large-folder REPO_ID LOCAL_PATH`: Recommended for resumable uploads of large directories. * `hf sync`: Sync files between a local directory and a bucket. * `hf env` / `hf version`: View environment and version details. ### Authentication (`hf auth`) * `login` / `logout`: Manage sessions using tokens from [huggingface.co/settings/tokens](https://huggingface.co/settings/tokens). * `list` / `switch`: Manage and toggle between multiple stored access tokens. * `whoami`: Identify the currently logged-in account. ### Repository Management (`hf repos`) * `create` / `delete`: Create or permanently remove repositories. * `duplicate`: Clone a model, dataset, or Space to a new ID. * `move`: Transfer a repository between namespaces. * `branch` / `tag`: Manage Git-like references. * `delete-files`: Remove specific files using patterns. --- ## Specialized Hub Interactions ### Datasets & Models * **Datasets:** `hf datasets list`, `info`, and `parquet` (list parquet URLs). * **SQL Queries:** `hf datasets sql SQL` — Execute raw SQL via DuckDB against dataset parquet URLs. * **Models:** `hf models list` and `info`. * **Papers:** `hf papers list` — View daily papers. ### Discussions & Pull Requests (`hf discussions`) * Manage the lifecycle of Hub contributions: `list`, `create`, `info`, `comment`, `close`, `reopen`, and `rename`. * `diff`: View changes in a PR. * `merge`: Finalize pull requests. ### Infrastructure & Compute * **Endpoints:** Deploy and manage Inference Endpoints (`deploy`, `pause`, `resume`, `scale-to-zero`, `catalog`). * **Jobs:** Run compute tasks on HF infrastructure. Includes `hf jobs uv` for running Python scripts with inline dependencies and `stats` for resource monitoring. * **Spaces:** Manage interactive apps. Includes `dev-mode` and `hot-reload` for Python files without full restarts. ### Storage & Automation * **Buckets:** Full S3-like bucket management (`create`, `cp`, `mv`, `rm`, `sync`). * **Cache:** Manage local storage with `list`, `prune` (remove detached revisions), and `verify` (checksum checks). * **Webhooks:** Automate workflows by managing Hub webhooks (`create`, `watch`, `enable`/`disable`). * **Collections:** Organize Hub items into collections (`add-item`, `update`, `list`). --- ## Advanced Usage & Tips ### Global Flags * `--format json`: Produces machine-readable output for automation. * `-q` / `--quiet`: Limits output to IDs only. ### Extensions & Skills * **Extensions:** Extend CLI functionality via GitHub repositories using `hf extensions install REPO_ID`. * **Skills:** Manage AI assistant skills with `hf skills add`.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
Manage Apple Notes via the memo CLI on macOS (create, view, search, edit).
Manage Apple Reminders via remindctl CLI (list, add, complete, delete).
Generate dark-themed SVG diagrams of software systems and cloud infrastructure as standalone HTML files with inline SVG graphics. Semantic component colors (cyan=frontend, emerald=backend, violet=database, amber=cloud/AWS, rose=security, orange=message bus), JetBrains Mono font, grid background. Best suited for software architecture, cloud/VPC topology, microservice maps, service-mesh diagrams, database + API layer diagrams, security groups, message buses — anything that fits a tech-infra deck with a dark aesthetic. If a more specialized diagramming skill exists for the subject (scientific, educational, hand-drawn, animated, etc.), prefer that — otherwise this skill can also serve as a general-purpose SVG diagram fallback. Based on Cocoon AI's architecture-diagram-generator (MIT).
Search and retrieve academic papers from arXiv using their free REST API. No API key needed. Search by keyword, author, category, or ID. Combine with web_extract or the ocr-and-documents skill to read full paper content.
Generate ASCII art using pyfiglet (571 fonts), cowsay, boxes, toilet, image-to-ascii, remote APIs (asciified, ascii.co.uk), and LLM fallback. No API keys required.
Production pipeline for ASCII art video — any format. Converts video/audio/images/generative input into colored ASCII character video output (MP4, GIF, image sequence). Covers: video-to-ASCII conversion, audio-reactive music visualizers, generative ASCII art animations, hybrid video+audio reactive, text/lyrics overlays, real-time terminal rendering. Use when users request: ASCII video, text art video, terminal-style video, character art animation, retro text visualization, audio visualizer in ASCII, converting video to ASCII art, matrix-style effects, or any animated ASCII output.
PyTorch library for audio generation including text-to-music (MusicGen) and text-to-sound (AudioGen). Use when you need to generate music from text descriptions, create sound effects, or perform melody-conditioned music generation.