ノードライブラリ (Node Libraries)
このセクションでは、Griptape Nodes の機能を拡張するインストール可能なノードバンドル群である ノードライブラリ (Node Libraries) について解説します。標準ライブラリ (Standard Library) は最初から標準インストールされています。その他のライブラリはそれぞれ独自の Git リポジトリで管理されており、エディタの ライブラリ (Libraries) パネルまたは gtn CLI を通じてインストールできます。
インストール手順、アップデート、依存関係の分離、共有/分離(Shared/Isolated)モードの仕組みについては、ライブラリガイド (Libraries guide) を参照してください。
ドキュメント化されているライブラリ (Documented libraries)
| ライブラリ | ノード数 | 用途 | 要件 |
|---|---|---|---|
| 標準ライブラリ (Standard Library) | 284 | デフォルトノード — エージェント、テキスト、画像、動画、音声、リスト、辞書、JSON、実行フローなど | なし(デフォルトでインストール済み) |
| Advanced Media Library | 28 | ローカルメディア生成および加工 — ディフュージョンパイプライン、画像/動画補助処理、LoRA、顔検出 | GPU 推奨、モデルダウンロード用の Hugging Face アカウント |
| OpenColorIO | 2 | OCIO 設定を使用したプロフェッショナルなカラーマネジメント — 映画、VFX、アニメーションパイプラインの業界標準システム | OCIO 設定ファイル($OCIO または明示的なパス) |
| OpenEXR | 4 | VFX および HDR 画像ワークフロー向けの OpenEXR ファイルの読み込み、検査、表示、保存 | なし(OpenColorIO との連携可能) |
| Nuke | 3 | キャンバスからヘッドレスで .nk スクリプトを実行し、ワークフローをバージョン管理された Nuke gizmo として公開 |
ローカルの Foundry Nuke インストールおよびライセンス |
| Diffusers | 19 | モジュラーな 🧨 Diffusers パイプライン — 個別に接続可能な拡散ステージからメディア生成ワークフローを構築 | GPU(CUDA または MPS) |
上記は網羅的なリストではありません。Griptape Nodes ディレクトリ (Griptape Nodes directory) では、さらに多くのファーストパーティおよびコミュニティ製ライブラリが提供されています。また、エディタの ライブラリの追加 (Add Library) モーダル内にある コミュニティライブラリを参照 (Browse Community Libraries) ボタンからも検索・閲覧できます。
ライブラリのインストール (Installing a library)
標準ライブラリは自動的に登録され、Advanced Media Library は gtn init の実行時にインストールの確認が行われます。このページに記載されているその他のライブラリは、すべて同様の手順でインストールできます:
- エディタで、管理 (Manage) → ライブラリ管理 (Library Management) を開きます。
- ライブラリの追加 (Add Library) をクリックし、ライブラリの Git URL(各ライブラリの概要ページに記載)を貼り付けます。
- インストール (Install) をクリックします。エンジンがリポジトリをクローンし、分離された仮想環境にライブラリの Python 依存関係をインストールして、ノードを登録します。
または、コマンドラインから実行します:
gtn libraries download <git_url>
各ライブラリの依存関係はエンジンおよび他のすべてのライブラリから完全に分離されているため、任意の組み合わせで安全にインストールできます。詳細は 共存保証 (Coexistence guarantees) を参照してください。
ドキュメントの構成 (How these docs are organized)
各ライブラリのドキュメントは以下のように構成されています:
- 概要ページ (Overview page) — ライブラリの機能、インストール方法、前提条件(環境変数、ハードウェア、アカウント)、および設定項目。
- ノードごとのリファレンスページ (Reference page per node) — 要約(TL;DR)、ワークフロー内での一般的な配置、入出力およびパラメータテーブルを含む統一フォーマット。