Nuke ライブラリ (Nuke Library)
Foundry Nuke 内部で動作するワークフローを構築します。本ライブラリは、Nuke 向けのワークフローを作成するためのフロー制御ノード、ワークフローをバージョン管理された .gizmo としてパッケージ化して Nuke スクリプトに配置可能にするパブリッシャー、および既存の .nk スクリプトをヘッドレスで実行してアノテーション付きノードを Griptape キャンバス上の型付きポートとして展開する Nuke Script ノードを提供します。
- リポジトリ: griptape-ai/griptape-nodes-library-nuke
- 要件: ローカル環境への Foundry Nuke のインストールおよびライセンス
- ノードカテゴリ: ノードピッカー内の
Foundry Nuke
インストール (Installation)
エディタで 管理 (Manage) → ライブラリ管理 (Library Management) を開き、ライブラリの追加 (Add Library) をクリックして以下を貼り付けます：
https://github.com/griptape-ai/griptape-nodes-library-nuke
または、CLI から実行します：
gtn libraries download https://github.com/griptape-ai/griptape-nodes-library-nuke
一般的なインストール、アップデート、トラブルシューティングの手順については、ライブラリガイド (Libraries guide) を参照してください。
提供ノード一覧 (Nodes)
| ノード | 説明 |
|---|---|
| Nuke Start Flow | Nuke 向けワークフローのエントリポイント — ワークフローを gizmo として公開するために必須 |
| Nuke End Flow | Nuke 向けワークフローの終端ノード。was_successful および result_details を出力 |
| Nuke Script | nuke -t 経由で .nk スクリプトをヘッドレス実行し、アノテーション付き Read/Write ノードを型付き入出力ポートとして展開 |
Nuke インストール環境の設定 (Configuring Nuke installations)
自動検出 (Auto-discovery)
ライブラリは起動時に標準的なインストール場所をスキャンし、Nuke Version ドロップダウンを自動的に生成します：
| OS | スキャン対象のパス |
|---|---|
| macOS | /Applications/Nuke* |
| Windows | %ProgramFiles%\Nuke*, %ProgramFiles(x86)%\Nuke* |
| Linux | /usr/local/Nuke*, /opt/Nuke*, ~/Nuke* |
また、PATH 環境変数内の Nuke または nuke という名前の実行可能ファイルも確認されます。新しいバージョンをインストールした後は、ノードの Refresh UI ボタンをクリックして再検出を実行できます。
エンジン設定による手動設定 (Manual configuration via Engine Settings)
非標準的な場所にインストールされている場合は、エンジン設定の nuke.installations キーにエントリを追加します：
{
"nuke": {
"installations": [
{
"display_name": "Nuke 16.0v7",
"executable_path": "/opt/nuke/16.0v7/Nuke16.0",
"annotator_nuke_version": 16
}
]
}
}
| フィールド | 必須 | 説明 |
|---|---|---|
display_name |
はい | Nuke Version ドロップダウンに表示されるラベル |
executable_path |
はい | Nuke バイナリへの絶対パス |
annotator_nuke_version |
いいえ | Nuke のメジャーバージョン。ロードされる Annotator パネルビルドを制御（デフォルト: 16） |
env_overrides |
いいえ | Nuke サブプロセスにマージされる追加環境変数 |
notes |
いいえ | 自由記述のメモ（ランタイムでは使用されません） |
追加のエンジン設定 (Additional engine settings)
| キー | 説明 |
|---|---|
nuke.executable |
インストールエントリが選択されていない場合に使用されるフォールバック Nuke バイナリパス |
nuke.env |
すべての Nuke サブプロセスに注入されるグローバル環境変数 |
nuke.nuke_path |
すべての呼び出しで NUKE_PATH に追加されるディレクトリのリスト |
Foundry ライセンス (Foundry license)
Griptape シークレットパネルで foundry_LICENSE を設定します。これは Nuke サブプロセスに自動注入されるため、env_overrides に直接ハードコードしないでください。
ワークフローの Nuke gizmo としての公開 (Publishing a workflow as a Nuke gizmo)
- 最上位フローが Nuke Start Flow ノードで始まり、Nuke End Flow ノードで終了するワークフローを構築します。
- ワークフローの公開 (Publish Workflow) を実行します（ワークフローの公開 を参照）。ダイアログで以下を選択します：
- プラグインパスの候補を解決するための Nuke インストール（自動検出）。
- gizmo のインストールパス —
~/.nuke、NUKE_PATH内のパス、Nuke インストールのプラグインディレクトリ、またはカスタムパス。 - 新規バージョンの作成か既存バージョンの上書きかを選択する 更新モード。
- Nuke 内部で、ノードツールバーの
Griptapeメニューから gizmo を作成するか、公開後にメインメニューバーのGriptape > Refresh Griptape Gizmosを実行して、Nuke を再起動せずに新しいバージョンを読み込みます。
公開処理により、選択したインストールディレクトリの下にバージョン管理された .gizmo とランナースクリプトが書き込まれ、Nuke のノードツールバーに Griptape サブメニューを追加する menu.py が生成されます。同じワークフローの複数の公開バージョンは、ワークフローごとのサブメニューにまとめられます。ワークフローの出力ファイルは、.nk ファイルの隣（griptape_outputs/<workflow_name>/... 配下）に保存されます。
サポート (Support)
バグの報告や機能リクエストについては、Issue を作成 してください。