windows 环境 hugging face修改镜像源
时间: 2025-04-19 09:56:43 浏览: 100
### 配置Hugging Face使用国内镜像源
为了提高下载速度并避免网络问题,在Windows环境中配置Hugging Face使用国内镜像是一个有效的解决方案。具体方法如下:
#### 安装必要的依赖项
确保已经安装了`huggingface_hub`库以及Git LFS(Large File Storage)。对于Windows环境,可以通过Chocolatey或Scoop等包管理器轻松完成这些工具的安装[^1]。
```powershell
choco install git-lfs
```
或者如果偏好使用Scoop:
```powershell
scoop install git-lfs
```
#### 修改环境变量
在Windows中设置环境变量以便能够正确识别本地安装的Git LFS路径。这一步骤类似于Linux下的做法,即通过调整系统的PATH环境变量来指向新安装的Git LFS可执行文件的位置[^3]。
打开“系统属性”对话框中的高级选项卡,点击“环境变量”,然后编辑Path变量,添加新的条目指向Git LFS二进制文件所在的目录,例如 `C:\Users\YourUsername\AppData\Local\scoop\apps\git-lfs\current\bin`.
#### 使用国内镜像源
针对Hugging Face Hub的操作,可以直接利用官方支持的方式切换至阿里云提供的加速服务。只需简单地运行下面这条Python代码即可实现自动化的配置过程[^2]:
```python
from huggingface_hub import login, HfFolder
login(token='your_token_here') # 如果有HF账户的话先登录
HfFolder.save_token('your_token_here')
import os
os.environ['TRANSFORMERS_CACHE'] = 'D:\\path\\to\\cache' # 可选:指定缓存位置
os.environ['TORCH_HOME'] = 'D:\\path\\to\\torch_cache' # 可选:PyTorch模型存储位置
# 切换到阿里云镜像站
os.environ["HF_HUB_ENABLE_HF_TRANSFER"] = "1"
os.environ["HF_DATASETS_OFFLINE"] = "0"
os.environ["HF_ENDPOINT"] = "https://modelscope.cn/"
```
上述脚本不仅更改了默认的API端点为ModelScope所提供的地址,还允许用户自定义本地缓存路径以更好地适应个人需求。
阅读全文
相关推荐

















