一、准备

huggingface-cli已经被huggingface官方弃用，所以在准备工具链时直接下载hugginface-hub即可，代码如下：

pip install huggingface-hub
pip install hf_transfer

接下来导入两个环境变量。

export HF_ENDPOINT=https://hf-mirror.com
export HF_HUB_ENABLE_HF_TRANSFER=1

二、下载

截止2025年12月3日，从huggingface上通过镜像网站下载模型/数据集使用的基础命令是 hf download,

它的用法如下：

hf download [-h] 
            [--repo-type {model,dataset,space}] 
            [--revision REVISION] 
            [--include [INCLUDE ...]] 
            [--exclude [EXCLUDE ...]] 
            [--cache-dir CACHE_DIR] 
            [--local-dir LOCAL_DIR] 
            [--force-download] 
            [--token TOKEN] 
            [--quiet]
            [--max-workers MAX_WORKERS]
            repo_id [filenames ...]

具体含义使用 hf download -h 查看即可。

三、示例

数据集

下载该数据集 https://huggingface.co/datasets/unitreerobotics/G1_Dex1_MountCameraRedGripper_Dataset/tree/v2.1

hf download --repo-type dataset --cache-dir xxx/xxx/ repo_id unitreerobotics/G1_Dex1_MountCameraRedGripper_Dataset

或者

hf download --repo-type dataset --cache-dir xxx/xxx/ unitreerobotics/G1_Dex1_MountCameraRedGripper_Dataset

二者皆可。

模型

下载该模型 https://huggingface.co/unitreerobotics/UnifoLM-WMA-0-Base

hf download --repo-type model --cache-dir xxx/xxx repo_id unitreerobotics/UnifoLM-WMA-0-Base

或

hf download --repo-type model --cache-dir xxx/xxx unitreerobotics/UnifoLM-WMA-0-Base

二者皆可