【Git】LFSでlarge fileのダウンロードが失敗する問題の解決法｜AIモデル取得時のエラー

この記事では、Git LFS（Large File Storage）を使ったAIモデルのクローン/ダウンロード時に失敗する問題について、海外コミュニティでの解決策を要約して解説します。

1. どんな問題（エラー）が発生したか？

• 発生した環境やツール： Git LFS、Hugging Face / GitHub上のAIモデルリポジトリ
• エラーメッセージ： Smudge error、error downloading object、batch response: This repository is over its data quota
• 症状： git clone時に大容量モデルファイル（数GB）のダウンロードが途中で失敗する

2. 結論（解決策）

Git LFSの帯域制限やタイムアウト、ネットワーク不安定が主な原因です。huggingface-cliやwgetでの直接ダウンロードに切り替えると安定します。

3. 具体的な手順

1. Git LFSをスキップしてリポジトリ構造のみクローン

   GIT_LFS_SKIP_SMUDGE=1 git clone https://huggingface.co/username/model

2. 必要なファイルのみ個別にダウンロード

   cd model
   git lfs pull --include="*.safetensors"

3. huggingface-cliを使う（推奨）

   pip install huggingface_hub
   huggingface-cli download username/model --local-dir ./model

   自動リジューム機能つきで安定性が高いです。

4. wgetで直接ファイルをダウンロード

   wget "https://huggingface.co/username/model/resolve/main/model.safetensors"

4. 補足・注意点

Git LFS帯域クォータの制限に達している場合、しばらく待つか別の方法でダウンロードしてください。企業プロキシ環境ではGit LFSのHTTPS通信がブロックされることがあり、その場合はIT部門に確認してください。

5.
👉 【RunPod】1時間数十円から使える高性能クラウドGPU

参考元

本記事は海外コミュニティの複数のディスカッションを要約・再構成したものです。

Source: Git LFS Documentation