【免费】几种好用的HuggingFace模型下载方法

小田测测看

发布于 2026-06-17 19:31:03

1720

Hugging Face 提供了丰富的预训练模型和数据集如果想要本地部署模型，可以从hugging face上下载，看网上有很多方法,亲测以下几种最实用：

方法一：直接下载

https://huggingface.co/deepseek-ai/DeepSeek-R1-Distill-Qwen-1.5B/tree/main

点击Files 点下载图标即可。无需登录直接点击下载，还可以复制下载链接，用其他下载工具(比如大家都喜爱的迅雷)下载。

方法二：使用hfd下载-- 推荐使用

❝hfd 是基于 curl 和 aria2 实现的专用于huggingface 下载的命令行脚本

先安装

wget https://hf-mirror.com/hfd/hfd.sh
# 下载完成后，给脚本增加执行权限：
chmod a+x hfd.sh

配置环境变量

为了让 HFD 能够正确地使用镜像加速下载，需要设置 HF_ENDPOINT 环境变量。根据使用的操作系统来执行相应的命令

Linux

在终端中运行以下命令：

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

为了让环境变量在每次启动终端时自动生效，可以将上述命令添加到 ~/.bashrc 或 ~/.zshrc 文件中：

echo 'export HF_ENDPOINT=https://hf-mirror.com' >> ~/.bashrc
source ~/.bashrc

Windows PowerShell

在 PowerShell 中运行以下命令：

$env:HF_ENDPOINT = "https://hf-mirror.com"

为了让环境变量在每次启动 PowerShell 时自动生效，可以将上述命令添加到 PowerShell 配置文件中（通常位于 Documents\PowerShell\Microsoft.PowerShell_profile.ps1）：

Add-Content -Path $PROFILE -Value '$env:HF_ENDPOINT = "https://hf-mirror.com"'

基本命令：

# 如果未安装 aria2，则可以改用 wget,默认是aria2
./hfd.sh deepseek-ai/DeepSeek-R1-Distill-Qwen-1.5B --tool wget


./hfd.sh deepseek-ai/DeepSeek-R1-Distill-Qwen-1.5B --include xxx.gguf

# 下载所有json文件
./hfd.sh deepseek-ai/DeepSeek-R1-Distill-Qwen-1.5B --include *.json

参数说明

`DeepSeek-R1-Distill-Qwen-1.5B·：要下载的模型名称，对应替换为你自己想下载的。
--tool wget：指定使用wget，也可以用 aria2c 作为下载工具，以支持多线程下载。
-x 4：设置 aria2c 的最大连接数为 4，加快下载速度
--include 指定下载特定文件
--exclude 排除特定文件的下载

完整命令格式

$ ./hfd.sh --help
用法:
  hfd <REPO_ID> [--include include_pattern1 include_pattern2 ...] [--exclude exclude_pattern1 exclude_pattern2 ...] [--hf_username username] [--hf_token token] [--tool aria2c|wget] [-x threads] [-j jobs] [--dataset] [--local-dir path]

描述:
使用提供的仓库ID从Hugging Face下载模型或数据集。

参数:
仓库ID          Hugging Face仓库ID(必需)
                格式:'组织名/仓库名'或旧版格式(如 gpt2)
选项:
包含/排除模式    用于匹配文件路径的模式,支持通配符。
                 例如:'--exclude *.safetensor .md', '--include vae/*'。
--include       (可选)指定要下载的文件包含模式(支持多个模式)。
--exclude       (可选)指定要排除下载的文件模式(支持多个模式)。
--hf_username   (可选)Hugging Face用户名用于认证(非邮箱)。
--hf_token      (可选)Hugging Face令牌用于认证。
--tool          (可选)使用的下载工具:aria2c(默认)或wget。
-x              (可选)aria2c的下载线程数(默认:4)。
-j              (可选)aria2c的并发下载数(默认:5)。
--dataset       (可选)标记下载的是数据集。
--local-dir     (可选)存储下载数据的目录路径。
                 默认下载到当前目录下以'仓库名'命名的子目录。(如果记仓库ID为'组织名/仓库名')。

方法三：huggingface-cli

需要*** Python>=3.8*** 安装

pip install -U huggingface_hub

基本下载模型命令

huggingface-cli download bigscience/bloom-560m --local-dir bloom-560m

ps: 下载经常会报 timeout 超时错误,可以加超时设定export HF_HUB_DOWNLOAD_TIMEOUT=30

方法四：使用国内镜像站

比如

https://hf-mirror.com/models?search=DeepSeek-R1-Distill-Qwen-1.5B

和huggingface一样操作，只是换了域名

#huggingface #模型下载 #AI #下载模型 #HuggingFace模型下载方法

本文参与腾讯云自媒体同步曝光计划，分享自微信公众号。

原始发表：2026-03-05，如有侵权请联系 cloudcommunity@tencent.com 删除

脚本

本文分享自编程拾光微信公众号，前往查看

如有侵权，请联系 cloudcommunity@tencent.com 删除。

本文参与腾讯云自媒体同步曝光计划，欢迎热爱写作的你一起参与！

登录后参与评论

0 条评论

热度