huggingface入门:如何使用国内镜像下载huggingface中的模型

3,740 阅读1分钟

前言

在使用huggingface中的模型时很多情况下会因为网络原因无法访问,导致模型的下载失败。为了应对这种问题,最便捷的方式是下载相应的模型后使用本地调用的方式,本文将介绍使用modelscope和hf-mirror镜像网站,下载并调用模型的方式来避免受网络影响模型的下载失败问题。


镜像网站

modelscope

镜像地址:www.modelscope.cn/models

打开主页如下 在这里插入图片描述

查找模型

本文中以下载qwen3为例,搜索后选择模型库 在这里插入图片描述 然后找到符合自身硬件条件的模型大小,一般来讲显存要比模型大小大一些,如果要秒出结果,最好显存比模型大两倍。 在这里插入图片描述 点进去选择模型文件,然后选择下载模型 在这里插入图片描述

使用modelscope下载模型

使用modelscope需要借助python环境并使用pip方式下载modelscope

pip install modelscope

在这里插入图片描述 下载时推荐设置一下模型保存路径,假设要保存的路径为./dir,下载命令如下

modelscope download --model Qwen/Qwen3-8B README.md --local_dir ./dir

使用迅雷下载(推荐)

这个下载方式需要下载迅雷以及浏览器下载迅雷下载插件 在这里插入图片描述

这个时候再打开网页就可以使用迅雷一键下载 在这里插入图片描述


hf-mirror

hf-mirror是huggingface的镜像网站 链接:hf-mirror.com/ 在这里插入图片描述 在这里插入图片描述 搜索并查找适合自己硬件的模型即可 git下载 git下载需要先下载并安装git 在这里插入图片描述 将显示出来的内容复制到命令行执行即可 在这里插入图片描述

迅雷下载(推荐) 在这里插入图片描述