モデルとライブラリの管理 (Managing Models and Libraries)

一部のノードは AI モデルをローカルで実行するため、実行前にディスク上にモデルファイルが存在している必要があります。また、まだインストールしていない外部ライブラリから提供されるノードもあります。これらは両方とも、エディタの Manage メニューにある Model Management（モデル管理）および Library Management（ライブラリ管理）ウィンドウから管理します。このページではその両方を解説します。

ライブラリの仕組み（インストールの分離方法、Shared（共有）実行と Isolated（分離）実行の違い、問題発生時の対処法など）については、ライブラリを参照してください。このページでは 2 つの管理ウィンドウ自体の操作方法を説明します。

モデル管理 (Model Management)

Manage → Model Management を開くと、モデルの検索、ダウンロード、およびクリーンアップを行うことができます。

このウィンドウで実行できるすべての操作は、ターミナルから gtn models コマンド（検索、ダウンロード、一覧表示、削除、ダウンロード状態確認）を使用しても実行可能です。CLI リファレンスを参照してください。

モデルの検索

検索ボックスに文字を入力すると、Hugging Face 上の一致するモデルがインクリメンタル検索されます。一致する結果がボックスの下にドロップダウン表示され、各モデルの ID、説明文（ある場合）、ダウンロード数、いいね数（Likes）、およびいくつかのタグが表示されます。すでにインストール済みのモデルには Installed バッジが付きます。結果をクリックして選択すると、エンジンがサイズを取得した後にモデルのサイズが表示され、Hugging Face で開くためのリンクが表示されます。

正確なモデル ID がすでにわかっている場合は、検索してドロップダウンから選択する代わりに、直接 ID を入力することもできます。

モデルのダウンロード

モデルを選択した状態で Download をクリックします。ダウンロードはバックグラウンドで開始されるため、作業を継続したり、ウィンドウを閉じたり、Library Management に切り替えたりしても、ダウンロードは中断されずに継続します。

進行状況の追跡

Downloads セクションには、現在進行中および直近で完了したすべてのダウンロードが一覧表示され、それぞれにステータスバッジが付きます：

ステータス	意味
Downloading	ダウンロード進行中。プログレスバー、総容量に対するダウンロード済み GB 数、およびパーセンテージが表示されます。
Completed	完了。バーが緑色で満たされます。
Failed	ダウンロード失敗。エントリの下にエラーメッセージが表示されます（Hugging Face のアクセス申請リンクが原因の場合はそれも含まれます。後述のゲート付きモデルにはトークンが必要を参照）。

リスト上部にある All / Downloads / Models チップを使用すると、アクティブなダウンロードのみ、またはインストール済みモデルのみに表示を絞り込むことができます。

ダウンロードのキャンセル

まだダウンロード中のエントリにあるゴミ箱アイコンをクリックするとキャンセルできます。まず Cancel Download 確認ダイアログが表示されます。Keep Downloading でダウンロードを継続し、Cancel Download で停止して途中までのダウンロード記録を削除します。

モデルの削除

Installed Models セクションには、すでにダウンロード済みのすべてのモデルが、ローカルパスとサイズとともに一覧表示されます。ゴミ箱アイコンをクリックするとモデルを削除できます。削除前に Delete Model 確認ダイアログが表示されます。削除は不可逆であり、ローカルストレージからファイルが完全に削除されます。そのモデルに依存しているワークフローは、再ダウンロードするか別のモデルを指定するまで実行に失敗するようになります。

ゲート付きモデルにはトークンが必要

Hugging Face 上の一部のモデルはゲート付き（利用申請が必要）になっています。モデルのページで利用申請を行う必要があり、さらに Griptape Nodes に Hugging Face アクセストークンを設定しておく必要があります。トークンが設定されていない場合、Model Management ウィンドウの上部にバナーが表示され、解決手順が案内されます：Hugging Face でトークンを作成し、Settings → API Keys & Secrets に HF_TOKEN として追加します。バナー内のリンクをクリックすると該当設定画面へ直接移動できます。

特定のゲート付きモデルへのアクセス申請方法を含む詳しい手順については、Hugging Face を使用するノードのセットアップを参照してください。

ライブラリ管理 (Library Management)

Manage → Library Management を開くと、ライブラリのインストール、更新、および削除を行うことができます。ターミナルからは、gtn libraries download <git-url> および gtn libraries sync コマンドでインストールと同期が行えます。CLI リファレンスを参照してください。

上部のフィルターバーでは、インストール済みライブラリを名前で検索でき、All / Updates / Errors チップでリストを絞り込むことができます。Errors は読み込みに失敗したライブラリを見つける最も素早い方法です。チップの隣にある 2 つのアイコンボタンを使用すると、すべてのライブラリの更新を確認 (check all libraries for updates) したり、リストを 更新 (refresh) したりできます。

任意のライブラリの行をクリックして展開すると、説明文、Git リモートとリファレンス（Git 経由でインストールされた場合）、およびエンジンの読み込み時に報告された問題の詳細を確認できます。

ライブラリのインストール

Add Library をクリックして Add Library ダイアログを開きます。コミュニティライブラリをホストしている GitHub リポジトリなどの Git URL を貼り付け、Install をクリックします。

エディタは実際にクローンを開始する前に、まずリポジトリを検査し、ライブラリ名、説明文、バージョン、ノード数の確認画面を表示します。意図したものでない場合はこの段階でキャンセルできます。

Advanced Options（URL フィールド下の展開メニュー）では、以下の設定が可能です：

Branch / Tag / Commit — リポジトリのデフォルトブランチの代わりに、特定のブランチ、タグ、またはコミットハッシュを指定してインストールします。
Download Directory — デフォルトのライブラリディレクトリ以外の場所へクローンしたい場合に、保存先フォルダを指定します。フォルダアイコンをクリックして参照できます。

何をインストールすればよいかわからない場合は、フォーム下部の Browse Community Libraries をクリックすると、厳選されたライブラリディレクトリが開きます。そこから URL をコピーして上記フィールドに貼り付けることができます。

保存先ディレクトリにすでに何かが存在している場合（同じライブラリの過去のインストールや無関係なファイルなど）、上書きするかどうかを確認するダイアログが表示されます。上書きは不可逆な操作です：既存の内容（Git チェックアウトのコミットされていない変更を含む）をすべて削除し、新しいインストールで置き換えます。ローカルに変更を加えたライブラリを更新する際にも、同様の上書き確認が表示されます。

ライブラリの更新

Git リモートを持つライブラリを展開し、Check for Updates をクリックすると、リモートと比較されます。アップデートが利用可能な場合、その行に Update ボタンが表示されます（エンジンがターゲットバージョンを把握している場合は Update to 1.4.0 のようにラベル付けされます）。クリックするとアップデートが適用されます。アップデートが保留中の場合（公開直後の不安定なバージョンを取り込まないよう、リリースから一定時間が経過するまで適用対象外とする安全策）、Update ボタンの代わりに適用可能になるまでの残り時間が表示されます。

また、展開した行から直接、ライブラリを別のブランチ、タグ、またはコミットに切り替えることも可能です：現在の ref をクリックしてその場で編集し、確定します。

ライブラリの依存関係が自動的にインストールされなかった場合は、展開した行の Install Dependencies をクリックすることで、ライブラリを再クローンすることなく依存関係のインストールのみを再試行できます。

ライブラリの削除

Library Management ウィンドウ自体は、ディスクからライブラリのファイルを直接削除する機能は備えていません。ライブラリを削除する方法や、削除せずに無効化（トグルオフ）する方法、Shared または Isolated の実行モードを選択する方法については、ライブラリガイドのライブラリの無効化と削除を参照してください。