Typed ComfyUI 3D node and workflow catalog for Isis.
Purpose#
@isis/3d-comfyui-nodes is the Phase 71 domain package for ComfyUI-native 3D
generation graphs. The scaffold intentionally mirrors the 71.9.x backlog so
subsequent tasks can land without reorganizing the package:
nodes: model-family node descriptors, ComfyUI category planning, and integration references into existing Isis 3D runtimesworkflows: workflow-template descriptors that compose node families with downstream post-pipeline and export capabilities
Implemented Surface#
71.9.1.1 establishes the Nx project scaffold, package exports, TypeScript and
Vitest configuration, typed library manifest, and curated catalogs for the
planned node families and workflow templates.
The current scaffold is intentionally not an empty shell. It already captures:
- the exact Phase
71.9.1.xnode families that still need implementation - the exact Phase
71.9.2.xworkflow templates that still need implementation - ComfyUI category planning for generation, texturing, post-processing, and export nodes
- concrete integration references into
@isis/3d-inference-local,@isis/ai-texturing,@isis/3d-post-pipeline, and the existing Python@isis/comfyui-nodescontrol-plane package
That gives the next tasks a stable home for actual ComfyUI node definitions, widgets, workflow JSON exports, and packaging hooks.
71.9.1.2 now adds the first executable node family in
src/nodes/trellis-2-node.ts. The package now provides:
- validated
@isis/comfyui-sdkNodeSpecs forTRELLIS.2 Text to 3DandTRELLIS.2 Image to 3D - an execution surface that routes requests across the existing local TRELLIS
text runtime, local TRELLIS.2 image and multi-image runtimes, local TRELLIS.2
GLB/GLTF export, and the HTTP
TrellisProviderbridge - explicit provider/runtime option coverage for quality presets, topology controls, sparse/SLAT steps, multi-image conditioning strategy, and textured delivery
71.9.1.3 adds the Hunyuan3D 2.1 node family in
src/nodes/hunyuan-3d-2-1-node.ts. The package now provides:
- chainable
Hunyuan3D 2.1 Text to ShapeandHunyuan3D 2.1 Image to Shapenodes over the local Hunyuan runtime - a separate
Hunyuan3D 2.1 Texturenode over the local Hunyuan3D-Paint stage - normalized custom result types so shape generation and texture synthesis can connect directly inside ComfyUI graphs
71.9.1.4 adds the SF3D node family in src/nodes/sf3d-node.ts. The package
now provides:
- an executable
SF3D Image to 3Dnode over the released local Stability AI fast single-image textured GLB runtime - explicit
SF3D UV UnwrapandSF3D Illumination Texturehelper nodes over the local UV-layout and relight-safe albedo export paths - normalized SF3D execution bundles so fast preview, UV inspection, and texture-review workflows can consume a consistent result shape
71.9.1.5 adds the SPAR3D node family in src/nodes/spar3d-node.ts. The
package now provides:
- an executable
SPAR3D Image to 3Dnode that surfaces both the textured GLB and the intermediate editable PLY point cloud - a
SPAR3D Point Cloud Editnode over the released point-cloud editing surface, including translate, scale, and recolor operations - persistent
SPAR3D SessionandSPAR3D Rendernodes that manage warmed preview-loop state through serializable session tokens, so ComfyUI graphs can preview, finalize, reset, and close interactive point-cloud sessions
71.9.1.6 adds the TripoSG node family in src/nodes/triposg-node.ts. The
package now provides:
- an executable
TripoSG Image to 3Dnode over the released single-image rectified-flow runtime with explicit guidance, FlexiCubes remesh, and MeshAnything cleanup controls - a
TripoSG Scribble to 3Dnode over the published TripoSG-scribble checkpoint with real prompt-plus-sketch conditioning and prompt/scribble confidence controls - a
TripoSG Multi-View Consistencynode that reconstructs per-view candidates, scores cross-view agreement, and returns the geometric medoid plus candidate metrics for graph-side inspection
71.9.1.7 adds the Sparc3D node in src/nodes/sparc3d-node.ts. The package now
provides:
- an executable
Sparc3D Image to 3Dnode over the local operator-bundle high-resolution pipeline with honest256^3,512^3, and1024^3planning - explicit
watertightversusopen-surfacecontrols that surface the corresponding topology-validation reports directly in the normalized result - optional FlexiCubes remesh and MeshAnything V2 cleanup routing without hiding the geometry-contract tradeoffs that make Sparc3D useful for printable or thin-structure workflows
71.9.1.8 adds the MeshAnything V2 node in src/nodes/meshanything-v2-node.ts.
The package now provides:
- an executable
MeshAnything V2 Remeshnode over the local MeshAnything remeshing pipeline instead of hiding topology cleanup inside upstream generation nodes only - generic mesh-source resolution that can consume prior Isis result bundles,
manual
{ mesh, meshFormat }payloads, or readable OBJ/PLY/GLB file paths - explicit face-budget, animation-ready edge-flow, Marching Cubes, and quad-dominant conversion controls with topology-quality comparison metadata in the normalized result bundle
71.9.1.9 adds the Hunyuan3D-Paint node family in
src/nodes/hunyuan3d-paint-node.ts. The package now provides:
- an executable
Hunyuan3D-Paint Standalonenode over the local standalone texturing pipeline for arbitrary upstream OBJ, PLY, or GLB meshes - a strict
Hunyuan3D-Paint Retexturenode that repaints existing OBJ or GLB assets while surfacing geometry-preservation and UV-preservation validation - generic mesh-source resolution plus normalized completeness metadata so texture-authoring graphs can chain any earlier Isis mesh result into a consistent painted-mesh bundle
71.9.1.10 adds the mesh export node in src/nodes/mesh-export-node.ts. The
package now provides:
- an executable
Mesh Exportnode over the real@isis/3d-post-pipelineexporters instead of a placeholder format switch - source normalization that can consume structured geometry, prior Isis result bundles, readable OBJ or PLY paths, or GLB, OBJ, and PLY bytes with an explicit format override
- format-honest controls for Draco and KTX2 GLB compression, FBX rig metadata, USDZ Quick Look validation and USDA retention, plus OBJ PBR channel-map derivation and legacy Phong fallback
71.9.2.1 adds the first executable workflow template in
src/workflows/text-to-game-asset-workflow.ts. The package now provides:
- a canonical
Text-to-Game-Assetworkflow definition grounded in the repo’s@isis/workflowsschema instead of another descriptor-only placeholder - explicit stage metadata for TRELLIS.2 text generation, MeshAnything V2 cleanup, Hunyuan3D-Paint surfacing, and final GLB export packaging
- typed package exports so downstream tooling can list implemented workflow templates separately from the remaining planned Phase 71 flows
71.9.2.2 adds the Image-to-3D-Print workflow template in
src/workflows/image-to-3d-print-workflow.ts. The package now provides:
- a canonical print-oriented workflow definition that keeps Sparc3D as the only ComfyUI node stage and models manifold repair plus STL export as explicit downstream post-pipeline stages
- print-honest delivery metadata that documents the geometry-only STL handoff, the repair report sidecars, and the reference QA artifacts instead of pretending the workflow ships textured runtime output
- typed package exports so downstream tooling can distinguish implemented print workflows from the remaining avatar, sketch, and batch-template backlog
71.9.2.3 adds the Photo-to-Avatar workflow template in
src/workflows/photo-to-avatar-workflow.ts. The package now provides:
- a canonical avatar workflow definition that chains Hunyuan3D 2.1 image-to-shape and texture stages into explicit universal-rigging and VRM export steps instead of leaving the avatar path as a descriptor-only placeholder
- stage metadata that documents the handoff from mesh generation into humanoid auto-rigging, facial and corrective blend-shape authoring, and final VRM 1.0 delivery semantics
- typed exports and manifest metadata so downstream tooling can discover the
implemented avatar workflow and its
@isis/universal-riggingdependency
71.9.2.4 adds the Sketch-to-3D workflow template in
src/workflows/sketch-to-3d-workflow.ts. The package now provides:
- a canonical sketch pipeline that uses TripoSG-scribble for coarse concept validation, reruns the sketch through SF3D UV refinement, preserves the refined layout through Hunyuan3D-Paint retexturing, and finishes with explicit GLB packaging
- typed workflow metadata that documents the honest TripoSG-to-SF3D bridge: SF3D remains image-conditioned in the current node surface, so refinement reruns the validated sketch input instead of pretending it consumes the coarse mesh directly
- export and manifest coverage so downstream tooling can treat sketch-driven GLB generation as an implemented workflow rather than a remaining placeholder
71.9.2.5 adds the Batch Asset Kit workflow template in
src/workflows/batch-asset-kit-workflow.ts. The package now provides:
- a canonical batch workflow that starts from a shared style reference and ordered asset list, extracts a reusable style profile, plans batch-safe per-item execution, and models TRELLIS.2, MeshAnything V2, Hunyuan3D-Paint, and dual mesh-export lanes as one executable template
- explicit batch-orchestration and style-consistency metadata grounded in the
repo’s existing
@isis/3d-asset-library,@isis/3d-inference-local, and@isis/operation-orchestratorsurfaces instead of treating “matching set” generation as vague prompt folklore - full catalog, manifest, and package-root export coverage so downstream tooling can treat the entire Phase 71 ComfyUI workflow set as implemented rather than leaving the batch kit path as the last descriptor-only placeholder