LM StudioでGGUFが表示されない・読み込めない時の確認ポイント｜保存場所・形式・量子化・容量を切り分ける

まず確認すること

• GGUFとは？親記事 - 読み方、GGUF版、Q4/Q5/Q8、モデル選びの全体像へ戻る
• GGUFモデル選び診断 - メモリ、GPU、用途から最初の候補を絞る

GGUFファイルが本当にダウンロードできているか

ダウンロード途中のファイル、0バイトに近いファイル、ブラウザで保存したHTMLページをGGUFだと思っているケースを先に除外します。Files上のサイズと手元のサイズが大きく違う場合は、再ダウンロードを検討します。

対応しているモデル形式か

拡張子が.ggufでも、LM Studioの現在のRuntimeやモデル構造に対応しているとは限りません。LM Studio公式Docsと配布ページの推奨ツールを確認し、別の軽いGGUFで同じ症状が出るか比べます。

• GGUFとsafetensors・MLX・Ollamaの違い - 形式と実行環境の違いを見る

unknown model architectureはRuntimeの対応状況も確認する

このエラーは、ファイルがGGUFであることだけでは解決しません。GGUF metadataにはarchitectureを表す値があり、読み込むRuntimeがそのmodel familyと必要なtensor/operationを実装している必要があります。ファイルサイズやSHA256が配布元と一致していても、使用中のRuntimeが新しいarchitectureに未対応ならloadできない場合があります。

1. エラー全文、LM Studioのversion、選択中Runtime/backend、model repoとGGUF filenameを記録する。
2. Model CardとFilesでbase model、GGUFの配布者、revision、quant、補助fileを確認する。
3. LM Studioの現行Runtime情報とモデル配布者の推奨環境を照合する。
4. 同じLM Studio/Runtimeで既知の小さなGGUFを試し、特定modelだけの問題か分ける。
5. 必要なら公式のruntime更新を検討し、更新前後のversionと結果を記録する。

mmprojはvision modelに組み合わせる補助fileです。mmproj単独を通常のchat modelとして読み込んだエラーや、ComfyUI等のdiffusion向けGGUFをLM Studioへ入れたエラーは、通常LLMのarchitecture非対応とは分けて扱います。

• llama.cppが対応するmodel architecture - GGUF runtime側の対応model一覧を見る
• llama.cppをWindowsで使う方法 - GGUF、backend、runtime versionの関係を確認する
• LM Studioで画像を読み込む - vision modelとmmprojの組み合わせを確認する

exitCode=1の直前に、どのファイルを開けなかったかを見る

「exited before becoming healthy」や「exitCode=1」だけでは、モデル、GGUF、GPUのどれが原因かは分かりません。同じ試行の詳細にtemplateファイルのopen失敗があるかを確認し、終了コードだけのケースと分けます。

LM Studioはmodel metadataからchat templateを自動選択する仕組みを説明しており、通常はoverrideを追加する必要はありません。明示的なtemplate指定がある場合も、まず記録されたpathを確認し、global TEMP/TMP、環境変数、Registryを変更して回避しないでください。

報告例を版と条件つきで比べるなら、Windows 11・LM Studio 0.4.20で非ASCII文字を含むTEMP pathの記述があるissue #2231が参考になります。これは投稿者の個別報告で、maintainerが一般原因として確定した説明ではありません。Changelogには0.4.20のengine log levelと0.4.21のerror表示改善がありますが、現行版での修正・継続状況までは断定できません。

1. 失敗した同じ試行の詳細を開き、終了コードより前にある具体的なerror行と引数を確認する。
2. app build、Runtime/backend、model識別子、context length、時刻を記録し、別の試行の情報と混ぜない。
3. --chat-template-fileとopen失敗pathの対応が明示されている場合だけ、そのtemplate入力pathの存在・アクセス条件をローカルで確認する。
4. 解決しない場合はmodel/configを保全し、ユーザー名・個人path・token・prompt・非公開model名などを伏せた必要最小限の行だけを開発者や管理者へ共有する。

保存場所・フォルダ構造の確認

LM Studioが管理する場所と、自分でダウンロードした場所が違う場合があります。手動で置いたGGUFが出ない時は、現在のアプリのimport手順、models directory、再スキャンの有無を確認してください。

• GGUFモデルの保存先はSSDとHDDどっち？ - 移動・保存先の考え方を見る

ファイルが途中で壊れていないか

• ファイルサイズが配布ページと大きく違う。
• ダウンロード中に回線が切れた。
• 外付けドライブへ移動中に中断した。
• 同名ファイルを上書きして途中状態になった。
• 複数ファイル分割やsidecarを誤って一部だけ置いた。

• GGUFファイル名の読み方 - 分割ファイルの番号と必要な一式を確認する

メモリ・VRAM不足の可能性

ロードできない原因がファイルではなくPC側の場合もあります。特に大きいモデル、Q8、長いcontext、他アプリの同時起動では、メモリ不足やVRAM不足で失敗しやすくなります。

• ローカルAIのモデルサイズ早見表 - PCメモリ別の一般的な目安を見る
• GPUオフロードとは - VRAMとCPU/GPU負荷を見る
• Windowsのコミット済みメモリとページファイルを確認する - RAM、GPU、ページファイルを混同せず記録する

量子化を軽くして試す

同じモデルでQ8_0が読めない場合でも、Q4_K_Mなら試せることがあります。原因切り分けでは、品質を上げるより先に「小さく、軽く、短く」戻すのが安全です。

それでも直らない時

1. LM Studio公式Docsと現在のアプリ画面を確認する。
2. 別の小さいGGUFを1本だけダウンロードして比較する。
3. エラー文、モデル名、量子化、ファイルサイズ、保存場所をメモする。
4. Hugging FaceのModel CardやIssuesで同様の報告がないか確認する。
5. 重要データを入れる前に、配布元とlicenseを再確認する。