AGENT SKILL
huggingface-hub
HuggingFace hf CLI: search/download/upload models, datasets.
- License 许可
- MIT
- 最近更新
- 2026-11-08
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- huggingface-hub
- tags
- [ "huggingface", "hf", "models", "datasets", "hub", "mlops" ]
- author
- Hugging Face
- license
- MIT
- version
- 1.0.1
- platforms
- [ "linux", "macos", "windows" ]
- description
- HuggingFace hf CLI: search/download/upload models, datasets.
03 SKILL.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
hfcommand replaces the now deprecatedhuggingface-clicommand.
Quick Start
- Installation:
curl -LsSf https://hf.co/cli/install.sh | bash -s - Help: Use
hf --helpto view all available functions and real-world examples. - Authentication: Recommended via
HF_TOKENenvironment variable or the--tokenflag.
Core Commands
General Operations
hf download REPO_ID: Download files from the Hub.hf upload REPO_ID: Upload files/folders (recommended for single-commit; also handles resumable uploads of large directories).hf upload-large-folder REPO_ID LOCAL_PATH: [Deprecated] — usehf uploadinstead.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.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, andparquet(list parquet URLs). - SQL Queries:
hf datasets sql SQL— Execute raw SQL via DuckDB against dataset parquet URLs. - Models:
hf models listandinfo. - Papers:
hf papers ls— View daily papers.
Discussions & Pull Requests (hf discussions)
- Manage the lifecycle of Hub contributions:
list,create,info,comment,close,reopen, andrename. 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 uvfor running Python scripts with inline dependencies andstatsfor resource monitoring. - Spaces: Manage interactive apps. Includes
dev-modeandhot-reloadfor 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), andverify(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.
04 同仓库更多 Skills
writing-plans
Write implementation plans: bite-sized tasks, paths, code.
★ 0
systematic-debugging
4-phase root cause debugging: understand bugs before fixing.
★ 0
subagent-driven-development
Execute plans via delegate_task subagents (2-stage review).
★ 0
plan
Write a markdown plan to .hermes/plans/; no execution.
★ 0
hermes-agent-skill-authoring
Author in-repo SKILL.md files: frontmatter and structure.
★ 0
debugging-hermes-tui-commands
Debug Hermes TUI slash commands: Python, gateway, Ink UI.
★ 0