Hugging Face 模型下载指南

安装

bash
展开代码
pip install -U huggingface_hub

国内镜像加速

bash
展开代码
export HF_ENDPOINT=https://hf-mirror.com

建议写入 ~/.bashrc 或 ~/.zshrc 永久生效：

bash
展开代码
echo 'export HF_ENDPOINT=https://hf-mirror.com' >> ~/.bashrc
source ~/.bashrc

基本用法

下载完整模型

比如下载ByteDance-Seed/UI-TARS-72B-DPO到-local-dir

bash
展开代码
huggingface-cli download \
  --resume-download \
  --local-dir-use-symlinks False \
  ByteDance-Seed/UI-TARS-72B-DPO \
  --local-dir /mnt/jfs6/model/UI-TARS-72B-DPO

下载单个文件

bash
展开代码
huggingface-cli download \
  --resume-download \
  --local-dir-use-symlinks False \
  模型仓库名 \
  文件名 \
  --local-dir 本地目录

示例：下载缺失的权重文件

bash
展开代码
huggingface-cli download \
  --resume-download \
  --local-dir-use-symlinks False \
  ByteDance-Seed/UI-TARS-72B-DPO \
  model-00029-of-00031.safetensors \
  --local-dir /path/to/UI-TARS-72B-DPO

批量下载指定文件

使用通配符模式：

bash
展开代码
huggingface-cli download \
  --resume-download \
  --local-dir-use-symlinks False \
  meta-llama/Llama-2-7b-hf \
  --include "*.safetensors" "*.json" \
  --local-dir ./llama2-7b

排除某些文件

bash
展开代码
huggingface-cli download \
  --resume-download \
  --local-dir-use-symlinks False \
  stabilityai/stable-diffusion-2 \
  --exclude "*.ckpt" "*.bin" \
  --local-dir ./sd2

常用参数说明

参数	说明
--resume-download	支持断点续传
--local-dir-use-symlinks False	不使用符号链接，直接复制文件
--local-dir	指定下载目录
--include	只下载匹配的文件
--exclude	排除匹配的文件
--repo-type	仓库类型：model（默认）、dataset、space