Skip to content

Repository files navigation

ComfyUI VNCCS Utils

A collection of utility nodes from the VNCCS project for everyday ComfyUI workflows, including VNCCS 3D Factory, VNCCS UniCanvas, VNCCS Pose Studio, and supporting generation utilities.

Join The Community
Share results, ask questions, and follow VNCCS updates.

Join our Discord
Support VNCCS
VNCCS is developed independently. Support helps keep the project moving.

Support VNCCS

VNCCS 3D Factory

VNCCS 3D Factory logo

VNCCS 3D Factory is a scene-oriented image-to-3D Gaussian workspace inside ComfyUI. It runs the open-source VAST-AI-Research/TripoSplat pipeline locally, turns reference images into editable 3D Gaussian models, keeps every generated object in a persistent scene, and renders the actual Gaussian assets through the bundled SparkJS viewport.

Key Features

  • True Gaussian Viewport: Multiple Gaussian PLY objects render together with orbit, pan, detail zoom, adaptive camera clipping, selection, and an optional grid—there is no synthetic floor mesh. Compact SPLAT payloads are generated lazily in one bounded, content-addressed cache rather than stored beside every model.
  • Scene Manager: Create and reopen scenes; generated objects, names, transforms, generation settings, and exports persist on the ComfyUI host.
  • Gaussian PLY Import: Add an existing validated Gaussian PLY to the active scene; it appears immediately in the object list and live viewport.
  • Interactive Transforms: Click objects in the viewport and move, rotate, or uniformly scale them with visible viewport gizmos. Exact numeric fields remain available in a collapsed precision panel.
  • Saved Scene Cameras: A graphical FPV look pad and roll control rotate the camera in place without changing normal viewport orbit behavior. Add up to 32 named scene cameras, click one to inspect its exact view, and receive the current view followed by every saved camera as an ordered ComfyUI IMAGE LIST at the shared Scene Export resolution.
  • Local TripoSplat Pipeline: The official pipeline runs in process with ComfyUI's PyTorch device. Model setup and weight download are graphical.
  • Object and Scene PLY Export: Export every transformed object separately or combine the visible scene as an editable Gaussian PLY. The export bakes transforms into the actual Gaussian centers and covariance, preserves opacity and spherical-harmonic color data, and embeds the current camera plus every saved scene camera without lossy triangle reconstruction.
  • Gaussian Library: Save individual objects or complete scenes with automatic 3D previews. .vnccs3d packages keep only canonical PLY assets, then synchronize or publish manifest-driven model repositories on Hugging Face through the Pose Studio repository workflow.
  • Observable Jobs: Background removal, image encoding, diffusion steps, Gaussian decoding, serialization, and scene insertion expose real progress. Every stage is printed to the ComfyUI console and retained in a downloadable per-job log.
  • Persistent Widget State: Scene selection, generation controls, source reference, object transforms and selection, current and saved cameras, grid, and transform mode are saved with the workflow. Reference images are persisted on the ComfyUI host rather than temporary browser file URLs.

👉 Setup and workflow guide

VNCCS UniCanvas

VNCCS UniCanvas logo

VNCCS UniCanvas is an integrated infinite-canvas image generation and editing workspace inside ComfyUI. It is designed for freeform creative work: generate anywhere, edit any region, build results across layers, and keep refining without being locked to a single fixed image boundary.

Key Features

  • Infinite Canvas Workflow: Work beyond a single image frame and place generations wherever the composition needs them.
  • Layer-Based Editing: Build images from separate raster and mask layers with visibility, opacity, selection, movement, and compositing controls.
  • Generation Anywhere: Use a selected region as the generation target for new images, image edits, inpaint, outpaint, and full-area transformations.
  • Mask and Object Tools: Paint masks, refine selections, and use SAM-powered object selection to isolate or remove parts of an image.
  • Preset and Custom Models: Switch between built-in presets or use manual model selection for supported generation backends.
  • Turbo and LoRA Controls: Use Turbo LoRA cards and a general LoRA Stack directly from the generation panel.
  • Canvas Editing Tools: Move, transform, resize, snap, undo/redo, and manage generation results without leaving the node.
  • Progress and Result Handling: Track generation progress and apply results back into the canvas as editable layers.

VNCCS Pose Studio

VNCCS Pose Studio logo

Example Workflows: QWEN · Klein9b

VNCCS Pose Studio is a professional 3D posing, framing, lighting, and pose-library environment running directly inside a ComfyUI node. It is designed for building high-quality pose/control references without leaving the graph: adjust the character body, pose bones interactively, frame the camera, tune lights, manage saved poses, and output single images or pose batches.

Key Features

  • Interactive 3D Viewport: Pose the mannequin directly in the node with selectable joints, bone manipulation, transform controls, and full Undo/Redo support.
  • Dynamic Body Generator: Fine-tune the character shape with sliders for Age, Gender blending, Weight, Muscle, and Height.
  • Multi-Pose Tabs: Create multiple independent pose states inside one node, making batch outputs and pose sequences easier to build.
  • Keyframe Animation Mode: Switch Pose Studio from static images to a dope-sheet timeline with per-bone tracks, playback, Auto-Key, draggable keys, easing presets, and deterministic frame output.
  • Mixamo FBX Animation Import: Import a Mixamo clip as one animated pose; Pose Studio switches to Animation mode and converts retargeted samples into bone keyframes instead of creating pose tabs.
  • Pose Copy/Paste: Transfer complex poses between tabs without rebuilding them from scratch.
  • Modal Pose Gallery: Save, browse, load, and delete poses in a focused full-screen gallery instead of cluttering the main workspace.
  • Pose Import/Export: Batch save and load pose data via JSON for reuse across workflows or projects.
  • Tracing Support: Load a background reference image and align the 3D character to it for accurate pose matching.
  • Precision Camera Controls: Set output dimensions, zoom, model rotation, and camera orbit with an integrated radar-style control.
  • Viewport Frame Preview: Preview the final render boundary directly in the viewport so composition matches the output.
  • Advanced Environment Lighting: Control Ambient, Directional, and Point Lights, including 2D radar controls for positioning point lights and radius controls for their influence.
  • Keep Original Lighting Mode: Bypass synthetic lighting for clean flat renders, useful for ControlNet-style pose/reference outputs.
  • Prompt-Aware Lighting Output: Generate descriptive lighting prompts that can be combined with your scene prompt.
  • Custom Prompt Templates: Use tag-based templates such as <lighting> and <user_prompt> to control how the final prompt is assembled.
  • Direct Sidebar Prompting: Add scene details in an auto-expanding prompt field directly inside the Pose Studio UI.
  • Flexible Export Modes: Output poses as a list or as a grid, with configurable background color.

👉 Detailed Usage Guide

Additional Nodes

VNCCS Visual Camera Control

Example Workflow

An interactive node with a visual widget for controlling camera position. It is designed for intuitive angle control and prompt generation, especially for multi-angle LoRAs like Qwen-Image-Edit-2511-Multiple-Angles.

  • Visual Widget: Select azimuth and distance with the mouse.
  • Elevation Slider: Pick elevation from -30° to 60°.
  • Trigger Word Toggle: Enable or disable the <sks> trigger from the widget.
  • Random Range Toggle: Randomize across the full 360° or restrict random views to the front ±45° while keeping elevation and distance random.

VNCCS QWEN Detailer

Example Workflow

A QWEN-Image-Edit2511 detailer for enhancing detected regions such as faces, hands, and objects with vision-guided instructions.

  • Smart Cropping: Automatically squares crops and handles padding.
  • Vision-Guided Enhancement: Uses QWEN-generated instructions or user prompts.
  • Drift Fix: Helps keep the enhanced area aligned with the original composition.
  • Quality of Life Tools: Includes color matching, Poisson blending, and upscaling options.
  • Inpainting Mode: Supports mask-based editing and filling black areas.
  • QWEN Options: Supports QWEN-Image-Edit2511-specific options such as distortion_fix and qwen_2511 mode.

VNCCS Model Manager & Selector

Example Workflow

A system for managing and selecting LoRAs and checkpoints directly in ComfyUI, with support for Civitai and HuggingFace.

VNCCS Model Manager

The backend node that reads a HuggingFace-hosted model_updater.json and manages model downloads.

  • Repo ID: Point the manager to your HuggingFace model repository.
  • Downloads: Queue and download models in the background.
  • Civitai Support: Use API key authentication for restricted Civitai models.

👉 Configuration Guide: How to create your own model repo

VNCCS Model Selector

The companion UI node for choosing models from the configured repository.

  • Visual Card UI: Shows model name, version, status, and description.
  • Smart Search: Opens a searchable modal model list.
  • Status Indicators: Shows Installed, Update Available, Missing, and Downloading states.
  • One-Click Install/Update: Install or update models directly from the selector.
  • Universal Connection: Outputs a standard relative path string compatible with standard ComfyUI nodes.

👉 Usage Guide: How to use Selector with Standard Loaders

VNCCS BBox Extractor

A helper node for extracting and visualizing crops when you need detected bounding-box regions without running a full face/detailer workflow.

Installation

Recommended: ComfyUI Manager

  1. Open ComfyUI Manager.
  2. Choose Custom Nodes Manager.
  3. Search for VNCCS Utils.
  4. Click Install.
  5. Restart ComfyUI.

Manual Installation

Open a terminal in your ComfyUI directory and run:

cd ComfyUI/custom_nodes
git clone https://github.com/AHEKOT/ComfyUI_VNCCS_Utils.git
cd ComfyUI_VNCCS_Utils
pip install -r requirements.txt

Open Model setup inside VNCCS 3D Factory to detect or download the official TripoSplat weights in the standard ComfyUI/models/{diffusion_models,vae,clip_vision,background_removal} folders. ComfyUI extra_model_paths are also searched. The inference pipeline runs directly in ComfyUI and does not require a separate server.

Restart ComfyUI after installation.

Star History

Star History Chart

About

A collection of utility nodes from the VNCCS project that are useful not only for the project's primary goals but also for everyday ComfyUI workflows.

Resources

Stars

1.0k stars

Watchers

16 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages