Kaggle Notebook离线安装transformers包失败，如何解决联网依赖问题？

问题根源 #

你安装的transformers开发版（4.57.0.dev0）要求setuptools>=40.8.0，但当前Kaggle环境的setuptools版本不达标，且离线状态下pip无法联网自动升级该依赖，导致安装失败。

解决步骤 #

1. 提前下载适配的setuptools wheel包
   在有网络的环境中，执行以下命令将符合版本要求的setuptools包下载到本地wheels目录：

   pip download setuptools>=40.8.0 -d ./wheels
   

   将这个wheels目录连同之前准备的transformers、huggingface-hub、tokenizers包一起上传到Kaggle的/kaggle/working/wheels路径下。

2. 离线升级setuptools
   在Kaggle Notebook中先执行以下命令，离线升级setuptools：

   !pip install --no-index --find-links /kaggle/working/wheels setuptools>=40.8.0 -U
   

3. 离线安装transformers
   完成setuptools升级后，再执行transformers的安装命令，同时指定本地依赖源避免联网：

   !pip install wheels/transformers-4.57.0.dev0.zip --verbose --no-index --find-links /kaggle/working/wheels
   

额外提示 #

• 确保下载的setuptools是适配Kaggle环境Python版本的.whl格式包，不要下载源码包，否则可能需要额外编译依赖。
• 如果transformers的zip包是源码形式，安装时可能还需要wheel、setuptools-scm等编译工具，建议提前在有网络环境中将这些依赖也下载到wheels目录中，一并离线安装。

内容的提问来源于stack exchange，提问作者user1700890