Skip to content

v0.1.3 — workflow polish + demo refresh + rescue speedup

Choose a tag to compare

View all tags
@dreamrec dreamrec released this 14 May 12:40
v0.1.3
e545dbe

Workflow polish, fresh demo images, and a one-line speedup to the cold-load path. No node-API changes — drop-in replacement for v0.1.2.

Changes since v0.1.2

Code

  • nodes/pixal3d_stages.py — _rescue_inference_tensors now short-circuits when the caller has already disabled inference_mode. run_pixal3d wraps the whole pipeline call in torch.inference_mode(mode=False), so any tensor allocated inside is already a regular tensor and the rescue is a no-op — but iterating 4× DinoV3 ViT-L + Pixal3D parameters at Python loop speed was costing ~20 minutes single-threaded on cold-load. Now it returns immediately.

Workflows (workflows/pixal3d_image_to_mesh.json + _with_external_rembg.json)

  • Interactive 3D viewer: added Trellis2ExportTrimesh → Preview3D chain so users see the textured mesh rotated in-canvas. The redundant 8-view Trellis2RenderPreview was removed (Preview3D is more useful for inspection).
  • Three-lane grid layout: Inputs (LoadImage + optional rembg) → Pipeline (Pixal3DImageToMesh sized 380×950 so every widget is visible) → Outputs (PreviewImage + Save GLB + Preview3D), all on a clean integer grid. The viewport extra.ds is pre-framed for 1080p.
  • In-canvas Note node with the verified low-VRAM tweak ladder for 12–16 GB cards.
  • Higher-quality safe defaults: 1024_cascade + 16/16/16 sampling steps + 65k tokens + 300k decimation + 4096 texture. ~3 min wall time when the pipeline is warm; ~7–10 min on the first run after a ComfyUI restart. Verified live on RTX 5090 — does NOT trip the comfy-aimdo 16 GB cast-buffer + 1536_cascade OOM ceiling.

Demo images (docs/images/)

  • demo_4view.png — 4 PBR-textured views (front / right-3/4 / back / left-3/4) of the new demo subject, rendered offline via pyrender at 2× SSAA with three-point lighting. Bypasses Trellis2RenderPreview's spike/aliasing artifacts.
  • demo_mesh_frontal.png — clay-shaded frontal view of the same mesh so reviewers can read geometry quality independent of the PBR bake.
  • New demo subject (examples/test_image.png) — significantly harder than the previous painted-miniature turtle; better showcase of what the pipeline does on intricate compositions.

README

  • Hero block updated with both demo images + clarifying captions (textured + clay).
  • VRAM-requirements line now points at the workflow's in-canvas Note for low-VRAM tuning.

Install paths

  • ComfyUI Desktop (via Comfy Registry): in-app node browser → search "Pixal3D". The bumped pyproject.toml auto-triggers a fresh registry publish.
  • ComfyUI Manager: search "Pixal3D".
  • Manual: cd ComfyUI/custom_nodes && git clone https://github.com/dreamrec/ComfyUI-Pixal3D && cd ComfyUI-Pixal3D && python install.py

Full diff: v0.1.2...v0.1.3

Assets 2
Loading