Hugging Face Offline Mode 离线模式

在使用 Hugging Face 的库时，缓存和遥测日志是两个重要的功能。本文将介绍如何管理缓存、启用离线模式以及如何关闭遥测日志。

1. 缓存管理

在使用 Hugging Face 模型时，权重和文件通常会从 Hub 下载并存储在默认的缓存目录中，这个目录通常位于用户的主目录。如果需要更改缓存位置，可以通过以下几种方式：

• 设置 HF_HOME 或 HUGGINGFACE_HUB_CACHE 环境变量。
• 在使用 from_pretrained() 方法时，配置 cache_dir 参数以指定缓存目录。

通过缓存文件，可以实现 🤗 Diffusers 离线运行。若想彻底阻止 Diffusers 连接网络，可以设置 HF_HUB_OFFLINE 环境变量为 True，这样它只会加载缓存中已有的文件，不会尝试从 Hub 下载新的文件。

设置方法如下：

export HF_HUB_OFFLINE=True  # Linux/MacOS

更多关于缓存管理和清理的内容，可以参考 Hugging Face 官方的缓存指南。

2. 遥测日志

🤗 在使用 from_pretrained() 方法时会收集一些遥测信息，这些信息包括：

• 请求的模型或管道类。
• 如果模型托管在 Hugging Face Hub 上，还会记录预训练检查点的路径。

这些数据用于帮助官方团队调试问题以及为新功能优先级提供参考。需要注意的是，遥测信息只有在从 Hugging Face Hub 加载模型时才会收集，如果从本地文件加载模型，则不会收集任何数据。

如果您不希望分享这些信息，可以通过设置 DISABLE_TELEMETRY 环境变量来关闭遥测日志。具体操作如下：

Linux/MacOS:

export DISABLE_TELEMETRY=YES

Windows:

set DISABLE_TELEMETRY=YES

通过以上设置，您可以更好地管理 Hugging Face 的缓存和隐私控制。

refer: https://huggingface.co/docs/diffusers/installation#cache