算子库 (Node Libraries)
本节系统记录了各类算子库 (Node Libraries)——即可安装的扩展算子包,用于大幅拓展 Griptape Nodes 的原生能力边界。标准基础算子库 (Standard Library) 默认预装;其他所有专业算子库均托管在各自独立的 Git 代码仓库中,可通过图形编辑器的 Libraries 面板或 gtn 命令行 CLI 灵活集成。
关于算子库的安装、升级、依赖环境隔离机制以及“共享/独立”运行模式的深入说明,请参阅 算子库管理手册。
已收录并提供文档支持的算子库
| 算子库名称 | 算子数 | 核心业务定位与能力范畴 | 前置环境依赖与运行要求 |
|---|---|---|---|
| 标准算子库 (Standard Library) | 284 | 开箱即用的核心基础算子——覆盖智能体、文本加工、图像生成、视频音效、列表字典处理、JSON 解析以及流程流控等 | 无(系统默认开箱即装) |
| 高级多媒体扩展库 (Advanced Media) | 28 | 本地多模态媒体生成与编辑——包含 Diffusion 扩散生图管线、图像/视频辅助前处理、LoRA 权重注入与面部精准检测 | 强烈推荐配备独立 GPU;需准备 Hugging Face 账号以拉取模型 |
| OpenColorIO 影视色彩管理 (OCIO) | 2 | 基于 OCIO 工业配置规范的专业级色彩流转——电影、高端影视视效 (VFX) 与三维动画工业级色彩管理标杆 | 本地需备有 .ocio 配置文件(通过 $OCIO 环境变量或显式路径指定) |
| OpenEXR 工业光魔高动态图层 | 4 | 面向 VFX 与 HDR 高动态影像管线的多通道、多分块 OpenEXR 文件快速加载、元数据探查、视口回显与无损落盘 | 无(可深度与 OpenColorIO 色彩算子联动协作) |
| Foundry Nuke 视效合成集成 | 3 | 无头模式 (nuke -t) 调度本地现有 .nk 工程,并将 Griptape 工作流一键打包发布为带版本管理的商业级 Nuke Gizmo 插件 |
本机已安装 Foundry Nuke 并具备合法商业或个人许可证 |
| Diffusers 模块化扩散管线 | 19 | 基于 🧨 Diffusers 体系的乐高化生图管线——将多模态扩散的不同阶段拆解为高度解耦、可自由连线组装的算子微元 | 需配备支持 CUDA (NVIDIA) 或 MPS (Apple Silicon) 的高性能硬件 |
注:以上并非完整穷尽清单——更多由官方团队或开源社区维护的丰富算子库,均已收录在官方的 Griptape Nodes 算子库索引目录 中。你亦可直接在图形界面的 Add Library 弹窗中点击 Browse Community Libraries 探索并即刻获取社区扩展。
算子库通用安装途径
Standard Library 会随引擎启动自动注册挂载,Advanced Media Library 则会在执行 gtn init 初始化向导时主动推荐安装。本页记录的其他所有专业算子库均遵循相同的标准化安装流:
- 在编辑器顶部菜单栏依次打开 Manage → Library Management;
- 点击 Add Library 并在输入框中粘贴目标算子库的 Git 仓库 URL(各算子库的具体仓库地址可参见对应概览页);
- 点击 Install。引擎会自动执行 Git Clone,并在底层沙盒中为该算子库构建独立的 Python 隔离虚拟环境,静默安装所有三方依赖并完成算子元数据注册。
亦可通过系统命令行 CLI 极速安装:
gtn libraries download <git_url>
每个算子库的底层运行依赖均与引擎主核及其他算子库实现了强物理隔离,因此你可以完全放心地自由组合、交叉安装任意数量的算子库而无需担心 Python 依赖版本冲突。详细原理请参见 算子库无缝共存保障机制。
算子库文档组织规范与阅读脉络
每个专业算子库文档均遵循严谨的工程化结构:
- 概览索引页 (Overview):清晰阐述该算子库的架构设计初衷、安装指令、前置硬件与依赖凭据(环境变量、模型权限等)以及专用引擎配置项;
- 算子专属技术参考页 (Per-node Reference):采用标准化规范排版,包含 TL;DR 核心速查、典型工作流编排拓扑、输入端口/输出端口矩阵、属性调优规范以及实战避坑指南。