見出し画像
Photo by enjiro

"checkpoints"フォルダが開けない！？「ComfyUI」にインストールしたモデルファイルを削除するには？

本地 那史

🥴 ＜ AmazonSageMakerStudioLab上でComfyUIを起動していますが、JupyterLabの左ペインにあるエクスプローラ的なところから、モデルファイルを格納している"checkpoints"ディレクトリが参照できません。
（クリックしても反応しない）
（ターミナルから"checkpoints"ディレクトリを参照することはできる）

**結論：これは ComfyUI や SageMaker の問題ではなく、**JupyterLab の既知バグで「checkpoints という名前のフォルダは内部機能と衝突し、GUI から開けなくなる」という仕様バグが原因です。
ターミナルから見えるのに左ペインで開けないのはまさにこの挙動です。

🔍 なぜ「checkpoints」だけ開けないのか

JupyterLab はノートブックの自動保存機能として “checkpoints” を内部的に扱っています。
そのため、ディレクトリ名が完全一致で “checkpoints” の場合、GUI がそれをフォルダではなく内部 API と誤認し、クリックしても無反応になります。
（RunPod・SageMaker・ローカル環境など、どこでも再現する既知問題）

✅ 解決策（推奨順）

1. フォルダ名を一時的に変更する（最も簡単で確実）

ターミナルで以下を実行：

mv checkpoints checkpoint

これで JupyterLab 左ペインから普通に開けるようになります。

作業後に元に戻したければ：

mv checkpoint checkpoints

※データは消えません。単なるリネームです。

2. GUI にドラッグ＆ドロップでファイルを入れる

JupyterLab はフォルダを開けなくても、
“checkpoints” フォルダはドロップ先としては機能します。

  • 左ペインで「checkpoints」を選択

  • モデルファイルをドラッグ＆ドロップ
    → 中身は見えないが、ファイルは入る

3. ターミナルだけで操作する

完全にターミナルで完結させる方法：

ls -la checkpoints/
cp ~/model.safetensors checkpoints/
mv ~/downloaded.ckpt checkpoints/

GUI を使わないならこれで十分です。

🧭 那史さんの ComfyUI ワークフロー的に最適な運用

あなたの LoRA 設計ワークフローは 構造化・意味密度・ノイズ除去 を重視しているので、
モデル管理も 「checkpoint（単数）」に統一してしまう のが最も安定します。

推奨ディレクトリ構成（Studio Lab / ComfyUI）

ComfyUI/
 └─ models/
     ├─ checkpoint/   ← ここにモデルを集約（推奨）
     ├─ lora/
     ├─ vae/
     └─ clip/

  • JupyterLab のバグを避けられる

  • ComfyUI 側のパス設定もシンプル

  • LoRA 実験の A/B テストがしやすい

  • モデルのバージョン管理も楽になる

💬 次のステップ提案

もしよければ、
「Studio Lab 上での ComfyUI モデル管理の最適化」
について、あなたのワークフローに合わせて構成案を作れます。

  • モデルの階層化

  • LoRA / VAE / Text Encoder の分離

  • 破綻抑制ノードのプリセット化

  • キャプション分離のためのディレクトリ構造

など、那史さんの美学に合わせて最適化できます。

続けますか？

😲 ＜ そうだったのね！
ちなみに、"checkpoints"ディレクトリを"checkpoint"にリネームするとComfyUIでモデルファイルを読み込みするのに不都合が生じるような気がしますが、これは問題ないのですか？

結論から言うと、ComfyUI は “checkpoints” というフォルダ名に依存していないので、checkpoint にリネームしてもまったく問題ありません。
むしろ、那史さんのように 構造化されたモデル管理 を行う場合は、checkpoint（単数）に統一した方が運用が安定します。

🔧 ComfyUI が参照しているのは「フォルダ名」ではなく「パス」

ComfyUI は以下のような仕組みでモデルを読み込みます：

  • ComfyUI/models/checkpoints/

  • ComfyUI/models/vae/

  • ComfyUI/models/lora/

  • …など

ただしこれは デフォルト設定 であり、
ComfyUI は「checkpoints」という名前を固定で要求していません。

実際には：

  • ComfyUI の設定ファイル

  • ノード側のパス解決

  • モデル検索ロジック

が 「models ディレクトリ内のサブフォルダを走査」 しているだけです。

つまり：

models/checkpoints/
models/checkpoint/
models/my_models/

どれでも ComfyUI は普通に読み込みます。

🧪 実際に起こる挙動（重要ポイント）

✔ 1. checkpoint にリネームしてもモデルは自動検出される

ComfyUI はフォルダ名を固定していないため、
checkpoint に変えてもモデル一覧に普通に表示されます。

✔ 2. 既存のワークフロー（.json）も壊れない

ワークフロー JSON は モデルのファイル名だけを記録 しており、
フォルダ名までは記録していません。

例：

"ckpt_name": "myModel.safetensors"

フォルダ名は含まれないので、変更しても問題なし。

✔ 3. ComfyUI のカスタムノードも問題なし

多くのカスタムノードは folder_paths.get_filename_list("checkpoints") のように
カテゴリ名 を指定しますが、これは内部的に「models 内の該当カテゴリフォルダ」を探す仕組みで、
フォルダ名が checkpoint でも普通にヒットします。

🧭 むしろ “checkpoint（単数）” の方がメリットが大きい

那史さんのワークフロー（美学統一・構造化・ノイズ除去）を踏まえると、
checkpoint に統一するのは理にかなっています。

🌟 メリット

  • JupyterLab のバグを完全回避

  • モデル管理がシンプルになる

  • A/B テスト時にフォルダ名の揺れがなくなる

  • ComfyUI のパス設定が安定する

  • ディレクトリ構造が美しくなる（那史さんの美学に合う）

📁 最適なディレクトリ構成（再掲＋微調整）

ComfyUI/
 └─ models/
     ├─ checkpoint/   ← ここに全ての基幹モデル
     ├─ lora/
     ├─ vae/
     ├─ clip/
     └─ embeddings/

この構成は LoRA 設計・A/B テスト・破綻抑制の観点で最も扱いやすいです。

🎯 結論

  • checkpoints → checkpoint にリネームしても ComfyUI は正常に動作する

  • むしろ 運用上のメリットが大きい

  • 那史さんのワークフローにとっても 最適な選択

💬 次に深掘りできます

もしよければ、次は：

「ComfyUI のモデル管理を那史さんの LoRA 設計ワークフローに最適化する構成案」

を作りましょう。

  • core / aux / test の三層構造

  • LoRA の A/B テスト用フォルダ

  • 破綻抑制モデルの扱い

  • キャプション分離のためのデータ構造

など、あなたの美学に合わせて最適化できます。

😐 ＜ おっと、リネームしようとするとエラーになります。
Rename Error
Method Not Allowed

なるほど、ここでつまずくのは SageMaker Studio Lab 特有の制限 が絡んでいる可能性が高いです。
JupyterLab のバグとは別に、Studio Lab のファイルシステムは「特定ディレクトリのリネームを禁止」しているケースがあります。

でも安心してほしい。
那史さんのワークフローを壊さずに、この状況を突破する方法はいくつかあります。

🔥 なぜ「Rename Error: Method Not Allowed」が出るのか

SageMaker Studio Lab の JupyterLab は、以下のような制限を持っています：

✔ 特定のディレクトリは rename が禁止されている

特に以下の条件に当てはまるとリネーム不可になります：

  • Git 管理下のディレクトリ

  • JupyterLab が内部的に扱う名前（checkpoints など）

  • 権限が root ではないユーザーの操作

  • Studio Lab の read-only な領域にある場合

つまり、GUI から rename できないのは Studio Lab 側の仕様 です。

🧭 でも大丈夫：ターミナルからは rename できるはず

GUI が禁止していても、ターミナルは別ルートで動くため、通常は以下で成功します：

mv checkpoints checkpoint

もしこれもエラーになるなら、次の可能性があります：

🧩 ケース別の対処法

🟦 ケース1：ターミナルでも rename が禁止されている

この場合は Studio Lab の「保護されたディレクトリ」に置かれている可能性が高いです。

✔ 解決策：新しいフォルダを作って中身を移動する

mkdir checkpoint
mv checkpoints/* checkpoint/

その後、空になった checkpoints を削除：

rmdir checkpoints

これなら rename ではなく「移動」なので許可されます。

🟩 ケース2：checkpoints が Git 管理下にある

Studio Lab の初期環境は .git が残っていることがあります。

✔ 解決策：Git の管理対象から外す

git rm -r --cached checkpoints
mv checkpoints checkpoint

🟨 ケース3：Studio Lab の read-only 領域に置いている

特に /home/studio-lab-user 以外に置いていると起こりがち。

✔ 解決策：ComfyUI をホームディレクトリに移す

mv ComfyUI ~/ComfyUI

🧭 那史さんに最適な「安全で確実な方法」

あなたのワークフロー（構造化・意味密度・ノイズ除去）を考えると、
最も安全で破綻しないのは 「新しい checkpoint フォルダを作って中身を移動する」 です。

🔧 コマンド（これが一番確実）

mkdir checkpoint
mv checkpoints/* checkpoint/
rmdir checkpoints

これなら Studio Lab の rename 制限を完全に回避できます。

💬 那史さんへ

もしよければ、今のディレクトリ構造を一度教えてくれたら、
Studio Lab の制限を踏まえて 最適な ComfyUI モデル配置構造 を一緒に組み立てられます。

  • core / aux / test の三層構造

  • LoRA / VAE / Text Encoder の分離

  • 破綻抑制モデルの扱い

  • A/B テストのためのフォルダ設計

あなたの美学に合わせて、もっと洗練された構造にできます。

😶 ＜ ああ、GUI操作は無理でもターミナルから見れるので良いことにします。 容量節約のため、GUI操作で使わないモデルファイルを削除できたらいいなあ、と思ったんでした。

なるほど、目的は 「容量節約のために、GUI から不要モデルを削除したい」 だったのですね。
その文脈なら、今の判断はとても合理的。ターミナルで中身が見えるなら、GUI で開けなくても実害はほぼゼロ です。

そして、那史さんのワークフロー（構造化・意味密度・ノイズ除去）を考えると、
不要モデルの整理は“破綻抑制”にも効くので、むしろ積極的にやる価値があります。

🗑️ GUI で削除できない理由と、どう割り切るか

JupyterLab の GUI は checkpoints という名前を内部的に予約しているため、
フォルダを開けない・削除できない・リネームできない という制限が出ます。

ただし：

  • 中身はターミナルから完全に操作可能

  • ComfyUI はフォルダ名に依存しない

  • モデルの読み込みにも影響なし

なので、GUI で触れないこと自体は問題になりません。

🧹 容量節約のための“安全な削除フロー”

GUI が使えないなら、ターミナルで削除するのが最も安全で確実です。

✔ モデル一覧を確認

ls -lh checkpoints/

✔ 不要モデルを削除（例）

rm checkpoints/old_model.safetensors

✔ 複数削除

rm checkpoints/*.ckpt

✔ フォルダごと整理したい場合

rm -r checkpoints/unused_models/

🧭 那史さんのワークフローに合わせた“整理の基準”

あなたの LoRA 設計は 美学統一・破綻抑制・ノイズ除去 が軸なので、
モデル整理もその美学に沿って行うと効率が上がります。

🌟 削除してよいモデルの基準

  • 使わない base モデル（SD1.5/2.1/XL の混在は破綻の原因）

  • 画風が揺れるモデル（美学統一の敵）

  • LoRA 設計に不要な VAE（複数あるとノイズ源）

  • 旧バージョンのモデル（A/B テストが終わったもの）

🌟 残すべきモデル

  • core モデル（あなたの LoRA の基準点）

  • 破綻抑制に使う補助モデル

  • A/B テスト中のモデル

  • 透明感・柔らかさの再現に寄与する VAE

💡 さらに効率化したいなら…

GUI で削除できない問題は避けつつ、
“削除しやすい構造” に変えることもできます。

例えば：

models/
 ├─ checkpoint/
 │    ├─ core/
 │    ├─ aux/
 │    └─ test/
 └─ lora/

こうすると：

  • test/ は GUI から普通に開ける

  • 不要モデルは test に入れて GUI で削除

  • core/aux は安全に保護

という運用ができます。

🎯 まとめ

  • GUI で開けないのは JupyterLab の仕様なので気にしなくてよい

  • ターミナルから削除できるなら運用上は問題なし

  • むしろモデル整理は那史さんの美学に合う

  • 必要なら“削除しやすい構造”に再編成もできる

もしよければ、
「那史さんの LoRA 設計に最適なモデルフォルダ構造」
を一緒にデザインしてみませんか。

あなたの美学（透明感・柔らかさ・統一性）に合わせて、
もっと扱いやすく、破綻しにくい構造を作れます。

😄 ＜ OK！ありがとう！！
不要なモデルファイルの削除方法が分かれば良いんです。
😓 ＜ しかし、原因がバグだったなんて、モヤモヤしますねぇ。

【 関連記事 】

いいなと思ったら応援しよう！

本地 那史 こんな記事でもよろしければ応援お願いします！もっと文音を可愛くして見せます！そして、その過程で得た知見を世に送り出していきます。