Transform your 3D texturing workflow with the power of generative AI, directly within Blender!
update installer to no longer force numpy < 2.0.0, update readme
sakalondff35d310352b
diff --git a/README.md b/README.mdindex 6f3451a..bb679ce 100644--- a/README.md+++ b/README.md@@ -46,6 +46,18 @@ StableGen brings AI-powered 3D generation and texturing directly into Blender:* **Smart mesh handling:** Auto-recovery from mesh corruption, configurable decimation/remeshing, import scaling, and studio lighting setup.* VRAM-conscious: disk offloading, configurable attention backend* Powered by [ComfyUI-TRELLIS2](https://github.com/PozzettiAndrea/ComfyUI-TRELLIS2) (installable via `installer.py`).+* 🖨️ **3D Printing & Slicing Suite:**+ * Export textured meshes directly into a multi-color format (3MF/STL) compatible with OrcaSlicer, Bambu Studio, and PrusaSlicer.+ * **Physical Color Mixing Solver:** Optimizes filament mixtures using Kubelka-Munk Theory (evaluating absorption $K$ and scattering $S$ coefficients).+ * **Speckle Bleed Prevention:** A one-sided saturation-difference penalty prevents pigments from bleeding as dither speckles into highly saturated regions.+ * **FDM Banding Culling:** Vectorized 8% threshold pruning filters out minor filament demands to keep layers clean.+ * **Viewport Slices Preview:** Projects and dithers color layers onto a flat-shaded preview mesh (`SG_SlicedPreview`) directly inside the Blender viewport.+ * *Requires enabling "Enable 3D Print Exporter Tab" in Addon Preferences.*+* 📂 **Folder Batching for Image-to-3D:**+ * Point StableGen at a directory of reference images to generate and texture multiple 3D assets in a single unattended run.+ * **Auto-Baking on Completion:** Automatically run texture baking (resolution, ORM packing, normal conventions) after each model is generated.+ * **Scene Isolation:** Automatically hides pre-existing assets during each generation stage to prevent texture bleed and projection contamination.+ * **Batch Performance Log:** Writes execution durations (Shape, Texture, Bake, and Total time) and success/error status reports to `stablegen_batch_log.json`.* 🌍 **Scene-Wide Multi-Mesh Texturing:*** Don't just texture one mesh at a time! StableGen is designed to apply textures to **all mesh objects in your scene simultaneously** from your defined camera viewpoints. Alternatively, you can choose to texture only selected objects.* Achieve a cohesive look across entire environments or collections of assets in a single generation pass.@@ -82,6 +94,9 @@ StableGen brings AI-powered 3D generation and texturing directly into Blender:* **Color Matching:** Match each generated view's colors to the current texture before blending, using multiple algorithms (MKL, Reinhard, Histogram, MVGD).* 🛠️ **Integrated Workflow Tools:*** **Camera Setup:** Quickly add and arrange multiple cameras with 7 placement strategies, per-camera aspect ratios, interactive occlusion preview, and customizable generation order.+ * **Auto-Aspect Camera Framing:** Dynamically apply auto-aspect ratio and optimal framing to cameras.+ * **SketchUp DAE Optimization:** Clean SketchUp Collada DAE imports with triangle fan fixes and interior face removal.+ * **Run Local Post-Processing:** Decimate, solidify, or retopologize meshes locally.* **View-Specific Prompts:** Assign unique text prompts to individual camera viewpoints for targeted details.* **Texture Baking:** Convert complex procedural StableGen materials into standard UV image textures. "Flatten for Refine" option lets you bake and continue editing.* **Debug Tools:** Visualize projection coverage, UV alignment, and weight blending without running AI generation.@@ -496,7 +511,10 @@ Click the arrow next to each title to expand and access detailed settings:A collection of utilities to further support your workflow:-* **Scene Queue:** Queue multiple assets for unattended batch processing. Add items with prompt and label, reorder, retry on failure. Supports both texturing and TRELLIS.2 pipelines with optional auto GIF export after each item.+* **Scene Queue:** Queue multiple assets for unattended batch processing. Add items with prompt and label, reorder, retry on failure. Supports both texturing and TRELLIS.2 pipelines with optional auto GIF export after each item. *(Must be enabled in Addon Preferences).*+* **3D Print Exporter:** Export models to slicer-ready multi-color 3MF files with custom filament spools, a physical color solver, and dither slice preview. *(Must be enabled in Addon Preferences).*+* **Run Local Post-Processing:** Decimate, solidify, or retopologize meshes locally.+* **Apply Auto Aspect:** Dynamically frame and aspect-scale selected cameras.* **Switch Material:** For selected objects with multiple material slots, quickly set a material at a specific index as the active one.* **Add HDRI Light:** Prompts for an HDRI image file and sets it up as the world lighting, providing realistic illumination for your scene.* **Apply All Modifiers:** Iterates through all mesh objects in the scene, applies their modifier stacks, and converts geometry instances into real mesh data. Helps prepare models for texturing.@@ -661,4 +679,4 @@ Ondřej Sakala* X/Twitter: `@sakalond`----*Last Updated: March 5, 2026*+*Last Updated: June 12, 2026*diff --git a/docs/MANUAL_INSTALLATION.md b/docs/MANUAL_INSTALLATION.mdindex d711ee3..77c8c3c 100644--- a/docs/MANUAL_INSTALLATION.md+++ b/docs/MANUAL_INSTALLATION.md@@ -276,6 +276,9 @@ Generate 3D meshes from a single image or text prompt. Models auto-download on f> **Note:** The TRELLIS.2 native textured output pipeline uses NVIDIA non-commercial libraries (nvdiffrast). Shape-only and SDXL/Qwen texture generation does not have this restriction.+> [!IMPORTANT]+> **Upgrade Action Required:** If you are upgrading from a previous version of StableGen, you **must manually delete** the old `ComfyUI-TRELLIS2` and `ComfyUI-Geometrypack` directories from your ComfyUI `custom_nodes/` directory first before cloning the new repository.+* **a) Install the ComfyUI-TRELLIS2 Custom Node**1. Navigate to your ComfyUI custom nodes directory:```bashdiff --git a/installer.py b/installer.pyindex 92742dc..fd8b3d4 100644--- a/installer.py+++ b/installer.py@@ -592,7 +592,7 @@ DEPENDENCIES: Dict[str, Dict[str, Any]] = {"target_dir_relative": "custom_nodes","repo_name": "ComfyUI-TRELLIS2","license": "MIT (Note: textured pipeline uses NVIDIA non-commercial libs)", "packages": ["trellis2"],- "pip_packages": ["numpy<2.0.0", "comfy-env"],+ "pip_packages": ["comfy-env"],"clean_envs": True,"run_install_script": True,"post_clone_patches": [@@ -1024,7 +1024,7 @@ def _patch_comfy_env_wheel_fallback(comfyui_path: Path):" _tv_m = _cu_re.search(display)"," if not _tv_m: continue"," _tv = int(_tv_m.group(1))",- " if _tv <= int(torch_short): continue",+ " if _tv <= int(torch_short.replace('.', '')): continue"," if py_tag not in display: continue"," if platform_tag and platform_tag not in display: continue"," if _best_tv is None or _tv < _best_tv:",@@ -1739,6 +1739,36 @@ def main():# Display TRELLIS.2 license notice if installing that packageif "trellis2" in selected_option["tags"]:+ # Check target environment's Python version+ try:+ python_exe = find_comfyui_python(comfyui_base_path)+ py_version_res = subprocess.run(+ [python_exe, "-c", "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}')"],+ capture_output=True, text=True, check=True+ )+ py_ver = py_version_res.stdout.strip()+ is_python_313_plus = [int(x) for x in py_ver.split(".")] >= [3, 13]+ except Exception:+ is_python_313_plus = sys.version_info >= (3, 13)++ if is_python_313_plus:+ print_separator(char='!')+ print("WARNING: PYTHON 3.13 COMPATIBILITY ALERT")+ print_separator(char='!')+ print("You are running Python 3.13+ in ComfyUI.")+ print("TRELLIS.2 requires binary CUDA extensions (cumesh, flex_gemm_ap, nvdiffrec, etc.)")+ print("which DO NOT currently have pre-compiled wheels for Python 3.13 on the wheel index.")+ print("Compiling them from source requires a local MSVC compiler and CUDA Toolkit.")+ print()+ print("It is HIGHLY RECOMMENDED to use Python 3.12 (or a ComfyUI portable build")+ print("that uses Python 3.12) to run the TRELLIS.2 mesh generation pipeline.")+ print_separator(char='!')+ ack_313 = input("Do you still want to attempt installation on Python 3.13? (y/n): ").strip().lower()+ if ack_313 != 'y':+ print("Installation cancelled.")+ print_separator()+ continue+print_separator(char='!')print("TRELLIS.2 THIRD-PARTY LICENSE NOTICE")print_separator(char='!')