mac系统下永久设置环境变量之【huggingface更换镜像站】

在 macOS 系统中永久设置 Hugging Face 镜像站的环境变量,可通过修改 Shell 配置文件实现。以下是具体步骤:

一、确认当前使用的 Shell

打开终端,执行以下命令查看当前 Shell:

bash 复制代码
echo $SHELL
  • 若输出为/bin/zsh (macOS 默认):使用.zshrc文件。
  • 若输出为/bin/bash :使用.bash_profile.bashrc文件。

二、设置 Hugging Face 镜像站环境变量

以下以 Zsh(默认) 为例,介绍如何设置:

1. 打开配置文件

bash 复制代码
open -e ~/.zshrc

若文件不存在,会自动创建。

2. 添加环境变量

在文件末尾添加以下内容(以清华镜像站为例):

bash

ini 复制代码
# Hugging Face 镜像站配置
export HF_ENDPOINT="https://hf-mirror.com"
export HF_HUB_DOWNLOAD_URL="https://hf-mirror.com"
export TRANSFORMERS_CACHE="$HOME/.cache/huggingface/transformers"
  • HF_ENDPOINT:指定 API 端点为镜像站。
  • HF_HUB_DOWNLOAD_URL:指定模型下载地址为镜像站。
  • TRANSFORMERS_CACHE:指定模型缓存路径(可选)。

3. 保存并使配置生效

关闭文件后,在终端执行:

bash 复制代码
source ~/.zshrc

或重启终端。

三、验证配置是否生效

执行以下命令查看环境变量是否正确设置:

bash 复制代码
echo $HF_ENDPOINT

若输出https://hf-mirror.com,则配置成功。

四、其他镜像站选项

除了清华镜像站,还可以使用以下镜像:

  • 阿里云镜像

    bash 复制代码
    export HF_ENDPOINT="https://mirror.aliyun.com/huggingface"
    export HF_HUB_DOWNLOAD_URL="https://mirror.aliyun.com/huggingface"
  • bfsu 镜像

    bash

    ini 复制代码
    export HF_ENDPOINT="https://mirrors.bfsu.edu.cn/hugging-face-models"
    export HF_HUB_DOWNLOAD_URL="https://mirrors.bfsu.edu.cn/hugging-face-models"

五、注意事项

  1. 多用户环境 :若需所有用户共享配置,可将环境变量添加到/etc/profile/etc/zshrc(需sudo权限)。

  2. 优先级:若同时设置多个镜像站,最后设置的生效。

  3. 临时覆盖:若需临时使用官方源,可在命令前临时指定:

    bash 复制代码
    HF_ENDPOINT="https://huggingface.co" python your_script.py

通过以上配置,后续使用 Hugging Face 相关工具(如transformers库)时,将自动从镜像站下载模型,大幅提升速度。

相关推荐
tan180°6 小时前
MySQL表的操作(3)
linux·数据库·c++·vscode·后端·mysql
优创学社27 小时前
基于springboot的社区生鲜团购系统
java·spring boot·后端
why技术7 小时前
Stack Overflow,轰然倒下!
前端·人工智能·后端
幽络源小助理7 小时前
SpringBoot基于Mysql的商业辅助决策系统设计与实现
java·vue.js·spring boot·后端·mysql·spring
ai小鬼头9 小时前
AIStarter如何助力用户与创作者?Stable Diffusion一键管理教程!
后端·架构·github
简佐义的博客9 小时前
破解非模式物种GO/KEGG注释难题
开发语言·数据库·后端·oracle·golang
Code blocks9 小时前
使用Jenkins完成springboot项目快速更新
java·运维·spring boot·后端·jenkins
追逐时光者10 小时前
一款开源免费、通用的 WPF 主题控件包
后端·.net