Install:
curl -LsSf https://hf.co/cli/install.sh | bash -s
.
The Hugging Face Hub CLI tool
hf
is available. IMPORTANT: The
hf
command replaces the deprecated
huggingface-cli
command.
Use
hf --help
to view available functions. Note that auth commands are now all under
hf auth
e.g.
hf auth whoami
.
Generated with
huggingface_hub v1.6.0
. Run
hf skills add --force
to regenerate.
Commands
hf download REPO_ID
— Download files from the Hub.
hf env
— Print information about the environment.
hf sync
— Sync files between local directory and a bucket.
hf upload REPO_ID
— Upload a file or a folder to the Hub. Recommended for single-commit uploads.
hf upload-large-folder REPO_ID LOCAL_PATH
— Upload a large folder to the Hub. Recommended for resumable uploads.
hf version
— Print information about the hf version.
hf auth
— Manage authentication (login, logout, etc.).
hf auth list
— List all stored access tokens.
hf auth login
— Login using a token from huggingface.co/settings/tokens.
hf auth logout
— Logout from a specific token.
hf auth switch
— Switch between access tokens.
hf auth whoami
— Find out which huggingface.co account you are logged in as.
hf buckets
— Commands to interact with buckets.
hf buckets cp SRC
— Copy a single file to or from a bucket.
hf buckets create BUCKET_ID
— Create a new bucket.
hf buckets delete BUCKET_ID
— Delete a bucket.
hf buckets info BUCKET_ID
— Get info about a bucket.
hf buckets list
— List buckets or files in a bucket.
hf buckets move FROM_ID TO_ID
— Move (rename) a bucket to a new name or namespace.
hf buckets remove ARGUMENT
— Remove files from a bucket.
hf buckets sync
— Sync files between local directory and a bucket.
hf cache
— Manage local cache directory.
hf cache ls
— List cached repositories or revisions.
hf cache prune
— Remove detached revisions from the cache.
hf cache rm TARGETS
— Remove cached repositories or revisions.
hf cache verify REPO_ID
— Verify checksums for a single repo revision from cache or a local directory.
hf collections
— Interact with collections on the Hub.
hf collections add-item COLLECTION_SLUG ITEM_ID ITEM_TYPE
— Add an item to a collection.
hf collections create TITLE
— Create a new collection on the Hub.
hf collections delete COLLECTION_SLUG
— Delete a collection from the Hub.
hf collections delete-item COLLECTION_SLUG ITEM_OBJECT_ID
— Delete an item from a collection.
hf collections info COLLECTION_SLUG
— Get info about a collection on the Hub.
hf collections ls
— List collections on the Hub.
hf collections update COLLECTION_SLUG
— Update a collection's metadata on the Hub.
hf collections update-item COLLECTION_SLUG ITEM_OBJECT_ID
— Update an item in a collection.
hf datasets
— Interact with datasets on the Hub.
hf datasets info DATASET_ID
— Get info about a dataset on the Hub.
hf datasets ls
— List datasets on the Hub.
hf datasets parquet DATASET_ID
— List parquet file URLs available for a dataset.
hf datasets sql SQL
— Execute a raw SQL query with DuckDB against dataset parquet URLs.
hf discussions
— Manage discussions and pull requests on the Hub.
hf discussions close REPO_ID NUM
— Close a discussion or pull request.
hf discussions comment REPO_ID NUM
— Comment on a discussion or pull request.
hf discussions create REPO_ID title
— Create a new discussion or pull request on a repo.
hf discussions diff REPO_ID NUM
— Show the diff of a pull request.
hf discussions info REPO_ID NUM
— Get info about a discussion or pull request.
hf discussions list REPO_ID
— List discussions and pull requests on a repo.
hf discussions merge REPO_ID NUM
— Merge a pull request.
hf discussions rename REPO_ID NUM NEW_TITLE
— Rename a discussion or pull request.
hf discussions reopen REPO_ID NUM
— Reopen a closed discussion or pull request.
hf endpoints
— Manage Hugging Face Inference Endpoints.
hf endpoints catalog
— Interact with the Inference Endpoints catalog.
hf endpoints delete NAME
— Delete an Inference Endpoint permanently.
hf endpoints deploy NAME repo framework accelerator instance_size instance_type region vendor
— Deploy an Inference Endpoint from a Hub repository.
hf endpoints describe NAME
— Get information about an existing endpoint.
hf endpoints ls
— Lists all Inference Endpoints for the given namespace.
hf endpoints pause NAME
— Pause an Inference Endpoint.
hf endpoints resume NAME
— Resume an Inference Endpoint.
hf endpoints scale-to-zero NAME
— Scale an Inference Endpoint to zero.
hf endpoints update NAME
— Update an existing endpoint.
hf extensions
— Manage hf CLI extensions.
hf extensions exec NAME
— Execute an installed extension.
hf extensions install REPO_ID
— Install an extension from a public GitHub repository.
hf extensions list
— List installed extension commands.
hf extensions remove NAME
— Remove an installed extension.
hf jobs
— Run and manage Jobs on the Hub.
hf jobs cancel JOB_ID
— Cancel a Job
hf jobs hardware
— List available hardware options for Jobs
hf jobs inspect JOB_IDS
— Display detailed information on one or more Jobs
hf jobs logs JOB_ID
— Fetch the logs of a Job.
hf jobs ps
— List Jobs.
hf jobs run IMAGE COMMAND
— Run a Job.
hf jobs scheduled
— Create and manage scheduled Jobs on the Hub.
hf jobs stats
— Fetch the resource usage statistics and metrics of Jobs
hf jobs uv
— Run UV scripts (Python with inline dependencies) on HF infrastructure.
hf models
— Interact with models on the Hub.
hf models info MODEL_ID
— Get info about a model on the Hub.
hf models ls
— List models on the Hub.
hf papers
— Interact with papers on the Hub.
hf papers ls
— List daily papers on the Hub.
hf repos
— Manage repos on the Hub.
hf repos branch
— Manage branches for a repo on the Hub.
hf repos create REPO_ID
— Create a new repo on the Hub.
hf repos delete REPO_ID
— Delete a repo from the Hub. This is an irreversible operation.
hf repos delete-files REPO_ID PATTERNS
— Delete files from a repo on the Hub.
hf repos duplicate FROM_ID
— Duplicate a repo on the Hub (model, dataset, or Space).
hf repos move FROM_ID TO_ID
— Move a repository from a namespace to another namespace.
hf repos settings REPO_ID
— Update the settings of a repository.
hf repos tag
— Manage tags for a repo on the Hub.
hf skills
— Manage skills for AI assistants.
hf skills add
— Download a skill and install it for an AI assistant.
hf skills preview
— Print the generated SKILL.md to stdout.
hf spaces
— Interact with spaces on the Hub.
hf spaces dev-mode SPACE_ID
— Enable or disable dev mode on a Space.
hf spaces hot-reload SPACE_ID
— Hot-reload any Python file of a Space without a full rebuild + restart.
hf spaces info SPACE_ID
— Get info about a space on the Hub.
hf spaces ls
— List spaces on the Hub.
hf webhooks
— Manage webhooks on the Hub.
hf webhooks create watch
— Create a new webhook.
hf webhooks delete WEBHOOK_ID
— Delete a webhook permanently.
hf webhooks disable WEBHOOK_ID
— Disable an active webhook.
hf webhooks enable WEBHOOK_ID
— Enable a disabled webhook.
hf webhooks info WEBHOOK_ID
— Show full details for a single webhook as JSON.
hf webhooks list
— List all webhooks for the current user.
hf webhooks update WEBHOOK_ID
— Update an existing webhook. Only provided options are changed.
Tips
Use
hf
hf-cli
安装
npx skills add https://github.com/huggingface/skills --skill hf-cli