コンテンツにスキップ

Griptape Nodes のアンインストール

インストールした方法に応じたセクションから開始してください：

その後、残存ファイルの確認と削除 で仕上げを行います。

ワークフローは自動削除されません

アンインストーラーがワークスペースディレクトリに手を加えることは一切ありません。そのため、自身で削除しない限り、プロジェクト、ワークフロー、および生成されたアセットはディスク上に残ります。保持したいものがある場合は、ワークスペースの削除 を実行する前に、安全な別の場所にコピーしておいてください。

Griptape Nodes デスクトップ版

デスクトップアプリケーションにはエンジンが同梱されており、専用のデータフォルダ内でエンジンのディレクトリを管理しています。

macOS

  1. Griptape Nodes を終了します。
  2. Finder で アプリケーション フォルダを開き、Griptape Nodes をゴミ箱にドラッグします。
  3. ゴミ箱を空にします。

この操作ではデータフォルダは削除されず残ります。アプリケーションデータの削除 を参照してください。

Windows

  1. Griptape Nodes を終了します。
  2. 設定 → アプリ → インストールされているアプリ を開きます。
  3. Griptape Nodes を見つけ、... メニューを開いて アンインストール を選択します。

Windows のアンインストーラーは以下の項目を削除します：

  • %LOCALAPPDATA%\ai.griptape.nodes.desktop 内のアプリケーション本体（ダウンロードされたアップデートパッケージを含む）。
  • スタートメニューおよびデスクトップのショートカット。
  • インストールされているアプリ の登録エントリ。
  • アプリケーションの両方のデータフォルダ（%APPDATA%\Griptape Nodes および %LOCALAPPDATA%\Griptape Nodes）。これにはアプリの設定、ログ、および API キーを含むエンジンが出力したすべてのファイルが含まれます。

続いて 残存ファイルの確認と削除 へ進んでください。

Linux

Griptape Nodes デスクトップ版は AppImage 形式で配布されています。これは特定の場所にインストールされない単一の実行可能ファイルです。

  1. Griptape Nodes を終了します。
  2. ダウンロードした .AppImage ファイルを削除します。
  3. AppImageLauncher などのツールを使用して AppImage をシステムに登録した場合は、そのツールを通じて削除し、~/.local/share/applications 配下のランチャーエントリも併せて削除してください。

その後、アプリケーションデータの削除 へ進んでください。

アプリケーションデータの削除 (macOS および Linux)

macOS および Linux では、アプリケーション本体を削除してもデータフォルダが残ります。これらのフォルダも手動で削除してください（Windows ではアンインストーラーによって同等のフォルダがすでに削除されています）。

項目 macOS Linux
アプリケーションデータ ~/Library/Application Support/Griptape Nodes ~/.config/Griptape Nodes
ログファイル ~/Library/Logs/Griptape Nodes ~/.config/Griptape Nodes/logs
ダウンロードされたアップデートパッケージ ~/Library/Caches/velopack/ai.griptape.nodes.desktop —

アプリケーションデータフォルダには、アプリの設定、サインインセッション、アクティベートしたライセンスキー、およびエンジンが出力したファイル（griptape_nodes_config.json、API キーやシークレットを含む .env ファイル、エージェントの会話スレッド、モデルのダウンロード履歴、ビデオプレビュー用にエンジンがダウンロードした ffmpeg バイナリなど）が格納されています。なお、ノードライブラリはここには含まれず、ワークスペース内に存在します（ワークスペースの削除 で個別に処理します）。Linux ではアップデートが一時ディレクトリにステージングされるため、ここでクリーンアップするものはありません。

アプリ内から正確なパスを確認する

アンインストールする前に、App Settings（アプリ設定）を開き、App Data Locations（アプリデータの保存場所）までスクロールしてください。お使いのマシンのアプリケーションデータフォルダのパスが表示され、Open ボタンを押すことで Finder やファイルマネージャーで直接開くことができます。ログファイルやアップデートパッケージはそこには表示されないため、上の表を参照してください。

その後、残存ファイルの確認と削除 へ進んでください。

手動でインストールしたエンジン

アンインストーラーを実行します：

gtn self uninstall

ターミナルに When done, press Enter to exit. と表示されたら Enter キーを押し、実行ファイルの削除を完了させます。これにより以下の項目が削除されます：

  • エンジンの設定およびデータディレクトリ（~/.config/griptape_nodes および ~/.local/share/griptape_nodes。API キーなどのシークレットを含む .env ファイルも含みます）。
  • uv tool uninstall griptape-nodes の実行による griptape-nodes および gtn コマンド。

Caveats（注意事項）セクションが表示された場合は、内容を確認してください。ワークスペースやプロジェクトフォルダ内の設定ファイルなど、削除されずに残されたファイルや、自動削除できず手動で削除する必要がある項目が一覧表示されます。

Windows におけるフォルダの場所

エンジンはすべてのプラットフォームで同一のレイアウトを採用しています。そのため、Windows における 2 つのフォルダは %USERPROFILE%\.config\griptape_nodes および %USERPROFILE%\.local\share\griptape_nodes となります。どちらも AppData ではなく、ユーザーのホームフォルダ直下に配置されます。

以前のアンインストールによって仮想環境が破損した状態のまま残っているなどして gtn が実行できない場合は、同じ作業を手動で行ってください：

uv tool uninstall griptape-nodes
rm -rf ~/.config/griptape_nodes ~/.local/share/griptape_nodes

Windows の PowerShell では以下を実行します：

uv tool uninstall griptape-nodes
Remove-Item -Recurse -Force "$env:USERPROFILE\.config\griptape_nodes"
Remove-Item -Recurse -Force "$env:USERPROFILE\.local\share\griptape_nodes"

その後、残存ファイルの確認と削除 へ進んでください。

残存ファイルの確認と削除

ワークスペースの削除

ワークスペースディレクトリには、プロジェクト、ワークフロー、生成されたアセット、およびノードライブラリが格納されており、自動的に削除されることはありません。デフォルトの場所は以下の通りです：

  • デスクトップアプリケーションを使用した場合は Documents/GriptapeNodes。
  • エンジンをご自身でインストールした場合は、最初に gtn コマンドを実行したディレクトリ内の GriptapeNodes フォルダ。

別の場所を指定していた可能性もあるため、アンインストール前にパスを確認してください。

保持したいファイルがあれば別の場所にコピーし、その後にフォルダを削除してください。

ダウンロードされたモデルの削除

ノードが Hugging Face Hub から取得したモデルは、Griptape Nodes のディレクトリではなく、システム共有の Hugging Face キャッシュに保存されます。

プラットフォーム パス
macOS / Linux ~/.cache/huggingface/hub
Windows %USERPROFILE%\.cache\huggingface\hub

マシン上の他のアプリケーションでも Hugging Face からモデルをダウンロードしている場合は、フォルダ全体を削除しないでください。手動でエンジンをインストールしている場合は、アンインストール前に Griptape Nodes のモデルのみを削除できます：

gtn models list
gtn models delete <model_id>

Griptape Nodes がまだインストールされている状態であれば、エディタの Model Management（モデル管理）ウィンドウから行うこともできます。モデルとライブラリの管理 を参照してください。

uv の削除

Griptape Nodes は、ノードライブラリ用の仮想環境を構築するために uv を使用しています。uv は独自のキャッシュと Python インタープリタを保持します。Griptape Nodes をインストールするためだけに uv を導入した場合は、uv の アンインストール手順 に従って、uv 本体とともにそれらを削除してください。

この手順を実行しても PATH 環境変数はそのまま残ります。uv のインストーラーによって実行ファイルのディレクトリ（~/.local/bin、Windows では %USERPROFILE%\.local\bin）が追加されているため、uv を削除した後はそのエントリを削除できます。macOS および Linux ではシェルプロファイルに追加された行を削除し、Windows では 設定 → システム → バージョン情報 → システムの詳細設定 → 環境変数 から削除してください。

再インストール

再度利用を開始する場合は、Griptape Nodes のインストール の手順を改めて実行してください。ワークスペースを保持していた場合、新規インストール時にそのワークスペースを指定すれば、以前のプロジェクトやワークフローをそのまま引き継ぐことができます。