huggingface-hub
Hugging Face Hub CLI (hf) — search, download, and upload models and datasets, manage repos, query datasets with SQL, deploy inference endpoints, manage Spaces and buckets.
- License 许可
- MIT
- 最近更新
- 2026-06-24
- Stars
- ★ 3
- Forks
- 1
01 前言 Front Matter
- name
- huggingface-hub
- tags
- [ "huggingface", "hf", "models", "datasets", "hub", "mlops" ]
- author
- Hugging Face
- license
- MIT
- version
- 1.0.0
- description
- Hugging Face Hub CLI (hf) — search, download, and upload models and datasets, manage repos, query datasets with SQL, deploy inference endpoints, manage Spaces and buckets.
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).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.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 list— 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.
? Связи
- [[000 - Map of Maps]] — REPO_DOCS
- [[000 - Map of Maps]] — Map of Maps
04 同仓库更多 Skills
ckm:ui-styling
Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs. Use when building user interfaces, implementing design systems, creating responsive layouts, adding accessible components (dialogs, dropdowns, forms, tables), customizing themes and colors, implementing dark mode, generating visual designs and posters, or establishing consistent styling patterns across applications.
ckm:design
Comprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG, Gemini 3.1 Pro), social photos (HTML→screenshot, multi-platform). Actions: design logo, create CIP, generate mockups, build slides, design banner, generate icon, create social photos, social media images, brand identity, design system. Platforms: Facebook, Twitter, LinkedIn, YouTube, Instagram, Pinterest, TikTok, Threads, Google Ads.
ckm:design-system
Token architecture, component specifications, and slide generation. Three-layer tokens (primitive→semantic→component), CSS variables, spacing/typography scales, component specs, strategic slide creation. Use for design tokens, systematic design, brand-compliant presentations.
ckm:banner-design
Design banners for social media, ads, website heroes, creative assets, and print. Multiple art direction options with AI-generated visuals. Actions: design, create, generate banner. Platforms: Facebook, Twitter/X, LinkedIn, YouTube, Instagram, Google Display, website hero, print. Styles: minimalist, gradient, bold typography, photo-based, illustrated, geometric, retro, glassmorphism, 3D, neon, duotone, editorial, collage. Uses ui-ux-pro-max, frontend-design, ai-artist, ai-multimodal skills.
seo
Comprehensive SEO analysis for any website or business type. Performs full site audits, single-page deep analysis, technical SEO checks (crawlability, indexability, Core Web Vitals with INP), schema markup detection/validation/generation, content quality assessment (E-E-A-T framework per Dec 2025 update extending to all competitive queries), image optimization, sitemap analysis, and Generative Engine Optimization (GEO) for AI Overviews, ChatGPT, and Perplexity citations. Analyzes AI crawler accessibility (GPTBot, ClaudeBot, PerplexityBot), llms.txt compliance, brand mention signals, and passage-level citability. Industry detection for SaaS, e-commerce, local business, publishers, agencies. Triggers on: "SEO", "audit", "schema", "Core Web Vitals", "sitemap", "E-E-A-T", "AI Overviews", "GEO", "technical SEO", "content quality", "page speed", "structured data".
seo-technical
Technical SEO audit across 9 categories: crawlability, indexability, security, URL structure, mobile, Core Web Vitals, structured data, JavaScript rendering, and IndexNow protocol. Use when user says "technical SEO", "crawl issues", "robots.txt", "Core Web Vitals", "site speed", or "security headers".