lm studio / deep guide

LM StudioでGGUFを選んでダウンロード・ロードする手順

LM Studioでローカルチャットを始めるための、検索→GGUF選択→ダウンロード→ロードの流れを初心者向けに解説します。 コマンドライン（lms）での取得・ロード方法と、メモリ見積もりの確認も含めます。

読了後に判断できること：GGUF版の見分け方、Instruct/Baseの使い分け、量子化の選び方、 CLIでの取得・ロード、resource estimate の確認、バージョン変化時の更新トリガー。

手順の全体像

  1. 検索：キーワード、user/model、またはHugging Faceの完全URLで対象を指定。
  2. GGUF版を選ぶ：検索結果からGGUF形式のものを選ぶ。同じ名前でsafetensors版と混在することがあるため注意。
  3. Instruct / Chat / IT を見る：会話用途なら会話向けに調整された表記があるものを選ぶ。
  4. 量子化を選ぶ：4-bit以上を出発候補にしつつ、量子化名ではなく実ファイルサイズとロード見積もりで決める。
  5. ダウンロード：選んだファイルをダウンロード（進捗が表示される）。
  6. ロード：ロードしてチャットを開始。メモリ不足等のエラーが出たら量子化/規模を見直す。
画面名称は変化する：検索・ダウンロード・ロードのUIはLM Studioのバージョンで名称・配置が変わります。 正確な手順は公式ドキュメント（出典一覧）で確認してください。本ページは「一般的な流れ」として記述。

LM Studioはキーワード、user/model、Hugging Faceの完全URLからモデルを探せます。 配布元（publisher/quantizer）ごとのバリエーションが表示されるため、同名だけで公式配布と判断しません。 各モデルのモデルカードには、対応タスク・言語・ライセンス・推奨量子化などが書かれていることが多いです。

  • publisher：元モデル開発者か、量子化配布者かを確認（安全な取得）。
  • variants：複数の量子化が並ぶ場合、自分の環境に合うものを選ぶ。
  • GGUF選択：safetensors と GGUF が混在することがあるため、GGUF であることを確認。

GGUF選択と Instruct / Base

同じモデル名で Instruct / Chat / IT 系と Base 系が並ぶことがあります。

Instruct系とBase系の使い分け
種別向き不適目安
Instruct / Chat / ITチャット・指示実行一般的な対話にはこちら
Base独自の微調整・補完通常のチャットには不向き（会話にならない）

チャットテンプレートは、Instruct 系ならモデルの metadata から自動適用されるのが一般的です。 Base 系を選ぶと「指示に従わない」ように見えることがあるため注意。

ロード時のパラメータ（一般的な項目）

ロード時に設定できる主な項目の方向性（名称はバージョンで変わります）：

ロードパラメータの目安
項目意味目安
context length扱うコンテキストの長さ現行LM Studioの既定8kを出発点に、必要な範囲だけ増やす。KVキャッシュ増（解説）
GPU offloadGPUへ載せる割合VRAMに余裕があれば増やす。不足時は下げる
flash attention高速化方式対応GPUで有効
vision / mmprojマルチモーダル画像入力なら有効化（解説）

Engine Protocol 等の通信方式はバージョンで変化します。詳細は公式ドキュメントを確認。

resource estimate の確認

現行CLIでは lms load --estimate-only <model_key> で、実際にロードする前に見積もりを確認できます。 --context-length と --gpu を付け、予定する条件を揃えます。 見積もりは「目安」であり、実際の使用量はモデル・設定・他プロセスで変わります。

コマンドを自分で組みたい場合は resource estimate コマンド作成ツール を利用（外部送信なし）。

CLI（lms）での取得・ロード

2026-08-31に公式ドキュメントで確認した流れ：

  • lms get --gguf user/model@q4_k_m：GGUFと量子化を指定して取得。完全なHugging Face URLも利用可能。
  • lms import <path>：ローカルの .gguf をインポート。
  • lms load --estimate-only <model_key> --context-length 8192 --gpu max：指定条件でロード前見積もり。
  • POST /api/v1/models/download：開発者向けローカルREST API。通常のGUI利用には不要。
将来versionは再確認：現行のGPUフラグは --gpu（off / 0〜1 / max）です。 --gpu-offload、--flash-attn、--vision を本サイトから推測で生成しません。更新後は lms load --help も確認してください。

ローカルファイルのインポート

Hugging Face等でダウンロードした .gguf ファイルを直接使う場合は、LM Studioのインポート機能から ローカルファイルを読み込ませます。ファイル名の量子化表記を確認してからロードしてください。 分割ファイルの場合は全シャードが揃っていることを確認（分割解説）。

バージョン変化と更新トリガー

  • 2026-08-28時点のchangelog最新はLM Studio 0.4.23。本文はversion番号を互換保証に使わない。
  • MTP assistant drafter等は対応engine versionの条件があるため、モデル名だけで利用可能と判断しない。
  • UIの名称・配置が変わったら、公式 changelog を確認。
  • 既定のコンテキスト長やロードパラメータの既定値が変わったら、本ページの手順を見直す。
  • Engine Protocol 等の通信方式が変わったら、互換性を確認。
  • 新しい量子化方式が追加されたら、量子化記事との整合を確認。
自分のPCで選ぶチェッカーへ メモリ・VRAMの目安へ 公式ドキュメントへ

更新履歴：2026-08-31 公式docs/changelogを再確認し、Hugging Face URL、lms get --gguf、現行 lms load flags、REST downloadを更新。