* refactor(skills): shipped-set slim — 15 skills to optional, github six-way merge, pdf absorbs OCR+nano-pdf, channel-gated teams pipeline
Maintainer-directed shipped-skills curation (skills index 1,900 -> ~1,400
tok/call on desktop; every session pays the index, so this is a per-call
diet on all installs):
- optional-skills moves (installable via skills hub, history preserved):
creative comfyui/ascii-art/excalidraw/pretext/sketch/touchdesigner-mcp;
ALL of mlops (huggingface-hub, llama-cpp, serving-llms-vllm,
weights-and-biases, evaluating-llms-harness — subcategory structure
kept); research-paper-writing (55 supporting files, 17.3K-tok load);
openhue; blogwatcher (first taught the cronjob monitor-field watch
pattern + web_extract instead of pre-cron manual workflows)
- DELETED session-librarian (Aug-12 'inspired by Perplexity Computer'
port, never maintainer-intended; session_search covers discovery)
- github: six skills (auth, issues, pr-workflow, issue-to-pr,
code-review, repo-management) merged into ONE software-development/
github skill — routing body + complete per-workflow references;
benbarclay authorship credited; codebase-inspection rides along;
discipline pins from test_github_issue_to_pr_skill.py preserved
against the reference body in the new test_github_skill.py
- pdf absorbs ocr-and-documents + nano-pdf as references/ + scripts
(extract_pymupdf, extract_marker converted to the argparse house
standard its contract test enforces)
- NEW session_platforms frontmatter gate (metadata.hermes): hides a
skill from the index on gateway channels it is not for; fail-open on
unknown platform; teams-meeting-pipeline gated to [teams, cron]
- blocked-page-recovery: research -> new web category; trigger-first
description ('Use when a fetch fails: 403/429, paywall, WAF, bot
wall.') so the model actually reaches for it on blocked fetches
- docs regenerated via generate-skill-docs.py (195 pages); related_skills
swept repo-wide; tests: 1672 passed (2 openclaw failures pre-existing
on clean main, Windows-local)
* chore: ignore .skills_prompt_snapshot.json (local index cache, accidentally committed)
3.6 KiB
3.6 KiB
name, description, version, author, license, tags, platforms
| name | description | version | author | license | tags | platforms | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| huggingface-hub | HuggingFace hf CLI: search/download/upload models, datasets. | 1.0.1 | Hugging Face | MIT |
|
|
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.