# StableGen
**Repository Path**: alegw/StableGen
## Basic Information
- **Project Name**: StableGen
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-18
- **Last Updated**: 2026-07-18
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# StableGen: AI-Powered 3D Generation & Texturing in Blender β¨
[](https://www.gnu.org/licenses/gpl-3.0)
[](#system-requirements)
[](https://github.com/sakalond/stablegen/releases)
**Create 3D assets from images and prompts, then texture and refine them - all inside Blender.**
StableGen is an open-source Blender addon that brings generative AI into your 3D workflow. **Generate** fully textured 3D meshes from a single image or text prompt via [TRELLIS.2](https://github.com/microsoft/TRELLIS.2), then **texture and refine** them - or any existing model - using SDXL, FLUX.1-dev, or Qwen Image Edit through a flexible [ComfyUI](https://github.com/comfyanonymous/ComfyUI) backend.
---
Table of Contents
- [π Key Features](#-key-features)
- [π Showcase Gallery](#-showcase-gallery)
- [π οΈ How It Works](#οΈ-how-it-works-a-glimpse)
- [π» System Requirements](#-system-requirements)
- [βοΈ Installation](#οΈ-installation)
- [π Quick Start Guide](#-quick-start-guide)
- [Texturing an Existing Model](#texturing-an-existing-model)
- [Generating a 3D Model with TRELLIS.2](#generating-a-3d-model-with-trellis2)
- [π Usage & Parameters Overview](#-usage--parameters-overview)
- [π Output Directory Structure](#-output-directory-structure)
- [π€ Troubleshooting](#-troubleshooting)
- [π€ Contributing](#-contributing)
- [π License](#-license)
- [π Acknowledgements](#-acknowledgements)
- [π‘ List of planned features](#-list-of-planned-features)
- [π§ Contact](#-contact)
---
## π Key Features
StableGen brings AI-powered 3D generation and texturing directly into Blender:
* π§ **TRELLIS.2: Image & Prompt to 3D:**
* Generate fully textured 3D meshes from a single reference image or text prompt using Microsoft's [TRELLIS.2](https://github.com/microsoft/TRELLIS.2) (4B-parameter model).
* **Multiple resolution modes:** 512, 1024, 1024 Cascade (recommended), and 1536 Cascade for maximum geometric detail.
* **Flexible texture pipeline:** Use TRELLIS.2's native PBR textures, or automatically texture the generated mesh with SDXL, FLUX.1-dev, or Qwen Image Edit for higher-quality diffusion textures.
* **Preview Gallery:** Generate multiple candidate images with different seeds and pick the best before committing to 3D generation.
* **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.
* Ideal for concept art, look development for complex scenes, and batch-texturing asset libraries.
* π¨ **Multi-View Consistency:**
* **Sequential Mode:** Generates textures viewpoint by viewpoint on each mesh, using inpainting and visibility masks for high consistency across complex surfaces.
* **Grid Mode:** Processes multiple viewpoints for all meshes simultaneously for faster previews. Includes an optional refinement pass.
* Sophisticated weighted blending ensures smooth transitions between views.
* π· **Advanced Camera Placement:**
* **7 placement strategies:** Orbit Ring, Fan Arc, Hemisphere, PCA-Axis, Normal-Weighted K-means, Greedy Occlusion Coverage, and Interactive Visibility-Weighted placement.
* **Per-camera optimal aspect ratios** - each camera gets its own resolution computed from the mesh's silhouette, so no pixels are wasted on letterboxing.
* **Unlimited cameras** - no more 8-camera limit.
* **Camera generation order** - drag-and-drop reorder list with 6 preset strategies to control the processing order in Sequential mode.
* Camera cloning, mirroring, and floating viewport prompt labels.
* π― **Local Edit Mode:**
* Point cameras at specific areas to modify - new texture blends seamlessly over the original using angle-based and vignette-based feathering.
* Separate angle ramp and silhouette edge feathering controls for precise blending.
* Works with all architectures (SDXL, Flux, Qwen Image Edit).
* π **Precise Geometric Control with ControlNet:**
* Leverage multiple ControlNet units (Depth, Canny, Normal) simultaneously to ensure generated textures respect your model's geometry.
* Fine-tune strength, start/end steps for each ControlNet unit.
* Supports custom ControlNet model mapping.
* ποΈ **Powerful Style Guidance with IPAdapter:**
* Use external reference images to guide the style, mood, and content of your textures with IPAdapter.
* Employ IPAdapter without an reference image for enhanced consistency in multi-view generation modes.
* Control IPAdapter strength, weight type, and active steps.
* βοΈ **Flexible ComfyUI Backend:**
* Connects to your existing ComfyUI installation, allowing you to use your preferred SDXL checkpoints, custom LoRAs, and the new Qwen Image Edit workflow alongside experimental FLUX.1-dev support.
* Offloads heavy computation to the ComfyUI server, keeping Blender mostly responsive.
* β¨ **Advanced Inpainting & Refinement:**
* **Refine Mode (Img2Img):** Re-style, enhance, or add detail to existing textures (StableGen generated or otherwise) using an image-to-image process.
* **Local Edit Mode:** Selectively modify specific areas while preserving the rest, with independent angle and vignette feathering controls.
* **UV Inpaint Mode:** Intelligently fills untextured areas directly on your model's UV map using surrounding texture context.
* **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.
* **HDRI Setup, Modifier Application, Curve Conversion, GIF/MP4 Export & Reproject.****
* π **Preset System:**
* Get started quickly with built-in presets for common scenarios (e.g., "Default", "Characters", "Quick Draft").
* Save and manage your own custom parameter configurations for repeatable workflows.
---
## π Showcase Gallery
See what StableGen can do!
Tip: Refresh the page to synchronize all GIF animations.
---
### Showcase 1: Text-to-3D (SDXL)
Assets generated entirely from a text prompt using the TRELLIS.2 pipeline with SDXL-based texturing.
| Dragon | Wizard | Hut |
| :------: | :------: | :------: |
| 
| 
| 
|
| **Telescope** | **Robot** | **Cyber Ninja** |
| 
| 
| 
|
Prompts used
1. **Dragon:** *"fantasy dragon"*
2. **Wizard:** *"wizard character, intricate embroidered purple and gold robes, pointed hat, wooden staff with glowing crystal, leather belt with pouches, fantasy character concept art, 4k"*
3. **Hut:** *"house, small house, cozy, wooden, hut"*
4. **Telescope:** *"antique brass telescope, tarnished patina with bright spots from handling, leather grip wrap, extended sections, mahogany tripod, product photography, 4k"*
5. **Robot:** *"giant robot, mecha, cyberpunk style, sci-fi, white body, intricate details, neon accents"*
6. **Cyber Ninja:** *"full body character, neutral pose, cyber-ninja, futuristic assassin, matte black carbon fiber stealth suit, hexagonal weave pattern, faceless helmet, glowing red neon visor slit, metallic silver shoulder armor, cyberpunk aesthetic, high contrast materials, unreal engine 5 render"*
### Showcase 2: Text-to-3D (Qwen)
Text-to-3D via TRELLIS.2 with Qwen Image Edit texturing - well-suited for stylized objects and crisp details.
| Barrel | Chest | Crate |
| :------: | :------: | :------: |
| 
| 
| 
|
| **Obelisk** | **Robot** | **Tree Stump** |
| 
| 
| 
|
Prompts used
1. **Barrel:** *"A chunky, stylized wooden barrel bound by thick, oversized iron hoops. The wood has deep, exaggerated hand-carved grooves"*
2. **Chest:** *"A highly detailed wooden treasure chest bound in heavy, dark iron. The chest is slightly open, revealing a pile of glowing gold coins inside. The wood is old and splintered, and the iron has patches of orange rust."*
3. **Crate:** *"A yellow industrial hazmat shipping crate. On the side, there is a large, highly legible warning label that says \"DANGER: BIOHAZARD\" in bold black letters. The crate has a digital keypad on the front and two red oxygen tanks strapped to the left side."*
4. **Obelisk:** *"An ancient, monolithic stone obelisk covered in glowing green runic carvings. The grey stone is deeply cracked from age and covered in patches of thick, fuzzy green moss."*
5. **Robot:** *"giant robot, mecha, cyberpunk style, sci-fi, white body, intricate details, neon accents"*
6. **Tree Stump:** *"A mystical, ancient gnarled tree stump with exposed, twisting roots. Growing out of the top is a cluster of translucent, glowing bioluminescent blue mushrooms and delicate, thin fern leaves. Fantasy RPG asset, hand-painted texture style mixed with photorealism, highly detailed."*
### Showcase 3: PBR Comparison
PBR material maps (roughness, metallic, normal) can be generated via Marigold decomposition. Each pair shows the same object without and with PBR materials.
| House | House (PBR) | Wizard | Wizard (PBR) |
| :------: | :------: | :------: | :------: |
| 
| 
| | 
|
| **Chest** | **Chest (PBR)** | **Obelisk** | **Obelisk (PBR)** |
| | 
| | 
|
| **Lunar Habitat** | **Lunar Habitat (PBR)** | **Scavenger** | **Scavenger (PBR)** |
| 
| 
| 
| 
|
| **Shaman** | **Shaman (PBR)** | **Cyberpunk Woman** | **Cyberpunk Woman (PBR)** |
| 
| 
| 
| 
|
| **Crate** | **Crate (PBR)** | **Tree Stump** | **Tree Stump (PBR)** |
| | 
| | 
|
Prompts used
1. **House (Qwen):** *"house, small house, cozy, wooden, hut"*
2. **Wizard (SDXL):** *"wizard character, intricate embroidered purple and gold robes, pointed hat, wooden staff with glowing crystal, leather belt with pouches, fantasy character concept art, 4k"*
3. **Chest (Qwen):** *"A highly detailed wooden treasure chest bound in heavy, dark iron. The chest is slightly open, revealing a pile of glowing gold coins inside. The wood is old and splintered, and the iron has patches of orange rust."*
4. **Obelisk (Qwen):** *"An ancient, monolithic stone obelisk covered in glowing green runic carvings. The grey stone is deeply cracked from age and covered in patches of thick, fuzzy green moss."*
5. **Lunar Habitat (SDXL):** *"futuristic lunar habitat module, domed cylinder base building, pristine white composite panels, high gloss reflections, gold foil wrapped pipes, circular metal airlock door, glowing blue exterior floodlights, sci-fi base architecture, clean PBR textures, hard surface modeling, 8k"*
6. **Scavenger (SDXL):** *"full body character, A-pose, post-apocalyptic scavenger, oil-stained olive green military jacket, tattered clothing, rusty street sign armor, dirty leather belts, scratched welding mask, wasteland survivalist, grunge textures, heavy weathering, fallout style character asset"*
7. **Shaman (SDXL):** *"full body character, A-pose, tribal shaman, rough woven brown wool, thick white animal fur, carved white bone mask, glowing purple magical runes, bare arms, fantasy RPG character class, organic textures, highly detailed displacement map, ZBrush sculpt style"*
8. **Cyberpunk Woman (Qwen):** *"A futuristic cyberpunk female mercenary standing in a neutral pose. She has a robotic left arm made of black metal and glowing blue wires. She wears a tactical jacket made of synthetic material with glowing LED strips on the collar and futuristic sneakers."*
9. **Crate (Qwen):** *"A yellow industrial hazmat shipping crate. On the side, there is a large, highly legible warning label that says \"DANGER: BIOHAZARD\" in bold black letters. The crate has a digital keypad on the front and two red oxygen tanks strapped to the left side."*
10. **Tree Stump (Qwen):** *"A mystical, ancient gnarled tree stump with exposed, twisting roots. Growing out of the top is a cluster of translucent, glowing bioluminescent blue mushrooms and delicate, thin fern leaves. Fantasy RPG asset, hand-painted texture style mixed with photorealism, highly detailed."*
### Showcase 4: PBR Gallery
A selection of assets with PBR materials enabled, demonstrating realistic surface response under varying lighting.
| Pot of Gold | Astrolabe | Tree Stump |
| :------: | :------: | :------: |
| 
| 
| |
| **Rabbit** | **Crate** | **Obelisk (Qwen)** |
| 
| | |
Prompts used
1. **Pot of Gold:** *"pot of gold"*
2. **Astrolabe:** *"A highly detailed, antique steampunk astrolabe resting on a rough-hewn wooden pedestal. The astrolabe features gleaming polished brass rings, tarnished copper gears, and a faceted glass crystal in the center. Studio lighting, photorealistic, 8k resolution, intricate mechanical details, isolated on a solid background."*
3. **Tree Stump:** *"A mystical, ancient gnarled tree stump with exposed, twisting roots. Growing out of the top is a cluster of translucent, glowing bioluminescent blue mushrooms and delicate, thin fern leaves. Fantasy RPG asset, hand-painted texture style mixed with photorealism, highly detailed."*
4. **Rabbit:** *"a white rabbit"*
5. **Crate:** *"A yellow industrial hazmat shipping crate. On the side, there is a large, highly legible warning label that says \"DANGER: BIOHAZARD\" in bold black letters. The crate has a digital keypad on the front and two red oxygen tanks strapped to the left side."*
6. **Obelisk (Qwen):** *"An ancient, monolithic stone obelisk covered in glowing green runic carvings. The grey stone is deeply cracked from age and covered in patches of thick, fuzzy green moss."*
---
### Showcase 5: Head Stylization (Texturing Only)
Texturing an existing model using prompts and style guidance from an IPAdapter image reference.
**3D Model Source:** "Brown" by ucupumar - Available at: [BlendSwap (Blend #15262)](https://www.blendswap.com/blend/15262)
| Untextured Model | Generated | Generated | Generated (with a reference image) |
| :------: | :---------: | :----------: | :-----------------: |
| 
| 
| 
| 
|
| *Base Untextured Model* | *Red Hair* | *Cyberpunk* | *Artistic Style* |
Prompts used
1. **Red Hair:** *"anime girl head, red hair"*
2. **Cyberpunk:** *"girl head, brown hair, cyberpunk style, realistic"*
3. **Artistic Style:** *"anime girl head, artistic style"* (style guided by IPAdapter reference image shown below)
Reference: "The Starry Night" by Vincent van Gogh (used to guide the "Artistic Style" variant)
### Showcase 6: Car Texturing (Texturing Only)
Texturing a car model using different prompts to achieve various visual styles.
**3D Model Source:** "Pontiac GTO 67" by thecali - Available at: [BlendSwap (Blend #13575)](https://www.blendswap.com/blend/13575)
| Untextured ModelΒ | Generated | Generated | Generated |
| :------: | :---------: | :----------: | :-----------------: |
| 
| 
| 
| 
|
| *Base Untextured Model* | *Green* | *Steampunk* | *Stealth Black* |
Prompts used
1. **Green:** *"green car"*
2. **Steampunk:** *"steampunk style car"*
3. **Stealth Black:** *"stealth black car"*
### Showcase 7: Scene Texturing (Texturing Only)
Texturing a complex scene consisting of many mesh objects.
**3D Model Source:** "Subway Station Entrance" by argonius - Available at: [BlendSwap (Blend #19305)](https://www.blendswap.com/blend/19305)
| Untextured SceneΒ | Generated | Generated | Generated |
| :------: | :---------: | :----------: | :-----------------: |
| 
| 
| 
| 
|
| *Base Untextured Scene* | *Subway Station* | *Fantasy Palace* | *Cyberpunk* |
Prompts used
1. **Subway Station:** *"subway station"*
2. **Fantasy Palace:** *"an overgrown fantasy palace interior, gold elements"*
3. **Cyberpunk:** *"subway station, cyberpunk style, neon lit"*
---
## π οΈ How It Works (A Glimpse)
StableGen acts as an intuitive interface within Blender that communicates with a ComfyUI backend.
1. You set up your scene and parameters in the StableGen panel.
2. StableGen prepares necessary data (like ControlNet inputs from camera views).
3. It constructs a workflow and sends it to your ComfyUI server.
4. ComfyUI processes the request using your selected diffusion models.
5. Generated images are sent back to Blender.
6. StableGen applies these images as textures to your models using sophisticated projection and blending techniques.
---
## π» System Requirements
* **Blender:** Version 4.2 β 4.5 (OSL projection) or Blender 5.1+ (GPU-accelerated projection via native Raycast nodes). **Blender 5.0 is not supported** (OSL is broken and native Raycast was not yet available).
* **Operating System:** Windows 10/11, Linux, or macOS (Apple Silicon).
* **GPU:** **NVIDIA GPU with CUDA is recommended** for ComfyUI. For further details, check ComfyUI's github page: [https://github.com/comfyanonymous/ComfyUI](https://github.com/comfyanonymous/ComfyUI).
* At least 8 GB of VRAM is required to run SDXL at a usable speed; plan for 16 GB or more when running FLUX.1-dev or the Qwen-Image-Edit pipeline.
* **ComfyUI:** A working installation of ComfyUI. StableGen uses this as its backend.
* **Python:** Version 3.x (usually comes with Blender, but Python 3 is needed for the `installer.py` script).
* **Git:** Required by the `installer.py` script.
* **Disk Space:** Significant free space for ComfyUI, AI models (10GB to 50GB+), and generated textures.
---
## βοΈ Installation
Setting up StableGen involves installing ComfyUI, then StableGen's dependencies into ComfyUI using our installer script, and finally installing the StableGen plugin in Blender.
Follow the stepβbyβstep instructions below to install StableGen.
If youβd rather watch, Polynox provides a concise video walkthrough:
[StableGen Installation & Basic Usage Video Tutorial](https://www.youtube.com/watch?v=EVNYAMnn_oQ)
### Step 1: Install ComfyUI (If not already installed)
StableGen relies on a working ComfyUI installation as its backend. This can be done on a separate machine if desired.
*If you wish to use a separate machine for the backend, do step 1 and 2 there.*
* If you don't have ComfyUI, please follow the **official ComfyUI installation guide**: [https://github.com/comfyanonymous/ComfyUI#installing](https://github.com/comfyanonymous/ComfyUI#installing).
* Install ComfyUI in a dedicated directory. We'll refer to this as ``.
* Ensure you can run ComfyUI and it's functioning correctly before proceeding.
### Step 2: Install Dependencies (Custom Nodes & AI Models) - Automated (Recommended)
The `installer.py` script (found in this repository) automates the download and placement of required ComfyUI custom nodes and core AI models into your ``.
**Prerequisites for the installer:**
* Python 3.
* Git installed and accessible in your system's PATH.
* The path to your ComfyUI installation (``).
* Required Python packages for the script: `requests` and `tqdm`. Install them via pip:
```bash
pip install requests tqdm
```
**Running the Installer:**
1. **Download/Locate the Installer:** Get `installer.py` from this GitHub repository.
2. **Execute the Script:**
* Open your system's terminal or command prompt.
* Navigate to the directory containing `installer.py`.
* Run the script:
```bash
python installer.py
```
Replace `` with the actual path. If omitted, the script will prompt for it.
3. **Follow On-Screen Instructions:**
* The script will display a menu of installation packages. Choose the option(s) that match the features you need.
* It will download and place files into the correct subdirectories of ``.
**Installer Packages Overview:**
| # | Package | What it enables | Size |
|---|---------|-----------------|------|
| 1 | Minimal Core | Basic SDXL texturing (bring your own checkpoint + ControlNets) | ~7.3 GB |
| 2 | Core + Preset Essentials | All built-in presets work out of the box | ~9.8 GB |
| 3 | **Recommended** Full SDXL Setup | SDXL texturing + PBR decomposition (no checkpoint) | ~19.3 GB |
| 4 | Complete SDXL + RealVisXL | Everything in #3 plus a ready-to-use checkpoint | ~26.3 GB |
| 5 | Qwen Core | Qwen Image Edit texturing architecture | ~20.3 GB |
| 6 | Qwen + Lightning LoRAs | Qwen with additional Lightning LoRAs | ~22.6 GB |
| 7 | Qwen Nunchaku | Qwen with Int4 quantized Nunchaku model (lower VRAM) | ~33.0 GB |
| 8 | TRELLIS.2 | Image/text-to-3D mesh generation (~5 GB install + ~15.4 GB models on first use) | ~20.4 GB |
| 9 | Marigold IID | PBR decomposition node (models auto-download on first use) | ~0.01 GB |
| 10 | StableDelight | Specular-free albedo for PBR (includes model download) | ~3.3 GB |
| 11 | FLUX.2 Klein *(experimental)* | Klein texturing architecture (~13 GB VRAM required) | ~12.4 GB |
**Common setups:**
- **Full 3D asset generation (SDXL):** Options 3 + 8 (or 4 + 8 with a checkpoint included)
- **Full 3D asset generation (Qwen):** Options 6 + 8
- **Texturing only (SDXL):** Option 3 (or 4)
- **Texturing only (Qwen):** Option 5 (or 6/7)
- **Add PBR to any setup:** Options 9 + 10 (included in options 3 and 4)
> **Note:** TRELLIS.2 and Marigold IID download additional models automatically on first use via HuggingFace. The sizes shown above include these first-use downloads. Expect the initial run to take longer.
4. **Restart ComfyUI:** If ComfyUI was running, restart it to load new custom nodes.
*(For manual dependency installation-including FLUX.1-dev and Qwen Image Edit setups-see `docs/MANUAL_INSTALLATION.md`.)*
### Step 3: Install StableGen Blender Plugin
1. Go to the [**Releases** page](https://github.com/sakalond/stablegen/releases) of this repository.
2. Download the latest `StableGen.zip` file.
3. In Blender, go to `Edit > Preferences > Add-ons > Install...`.
4. Navigate to and select the downloaded `StableGen.zip` file.
5. Enable the "StableGen" addon (search for "StableGen" and check the box).
### Step 4: Configure StableGen Plugin in Blender
1. In Blender, go to `Edit > Preferences > Add-ons`.
2. Find "StableGen" and expand its preferences.
3. Set the following paths:
* **Output Directory:** Choose a folder where StableGen will save generated images.
* **Server Address:** Ensure this matches your ComfyUI server (default `127.0.0.1:8188`).
* Review **ControlNet Mapping** if using custom named ControlNet models.
4. Enable online access in Blender if not enabled already. Select `Edit -> Preferences` from the topbar of Blender. Then navigate to `System -> Network` and check the box `Enable Online Access`. While StableGen does not require internet access, this is added to respect Blender add-on guidelines, as there are still network calls being made locally.
---
## π Quick Start Guide
### Texturing an Existing Model
Hereβs how to get your first texture generated with StableGen:
1. **Start ComfyUI Server:** Make sure it's running in the background.
2. **Open Blender & Prepare Scene:**
* Have a mesh object ready (e.g., the default Cube).
* Ensure the StableGen addon is enabled and configured (see Step 4 above).
3. **Access StableGen Panel:** Press `N` in the 3D Viewport, go to the "StableGen" tab.
4. **Add Cameras (Recommended for Multi-View):**
* Select your object.
* In the StableGen panel, click "**Add Cameras**". Choose `Object` as center type. Adjust interactively if needed, then confirm.
5. **Set Basic Parameters:**
* **Prompt:** Type a description (e.g., "ancient stone wall with moss").
* **Architecture:** Pick the diffusion family (`SDXL`, `Flux 1`, or `Qwen Image Edit`) that matches the workflow you set up.
* **Checkpoint:** Select a checkpoint or GGUF file suited to the chosen architecture (e.g., `sdxl_base_1.0` or `Qwen-Image-Edit-2509-Q3_K_M.gguf`).
* **Preset:** Choose a preset and apply it. `Default` or `Characters` are good starting points.
6. **Hit Generate!** Click the main "**Generate**" button.
7. **Observe:** Watch the progress in the panel and the ComfyUI console. Your object should update with the new texture! Output files will be in your specified "Output Directory".
* By default, the generated texture will only be visible in the Rendered viewport shading mode (CYCLES Render Engine).
### Generating a 3D Model with TRELLIS.2
Follow these steps to generate a fully textured 3D mesh from a text prompt or reference image using the TRELLIS.2 pipeline:
1. **Prerequisites:** Make sure you have the TRELLIS.2 dependencies installed (see [Installation - Step 2](#step-2-install-dependencies-custom-nodes--ai-models---automated-recommended)) and that your hardware meets the [System Requirements](#-system-requirements).
2. **Choose a Preset:** Select and apply one of the **(MESH + TEXTURE)** labeled presets:
* **SDXL** - best for creative, prompt-driven workflows.
* **Qwen Image Edit** - well-suited for stylized generations, legible text, and specific details. Particularly effective for image-to-3D workflows (turning a picture into a 3D model).
* Hover over any preset in Blender for a detailed description of what it does.
* Alternatively, use the **TRELLIS.2 (MESH ONLY)** preset if you only need the generated mesh without automatic texturing.
3. **Select Input Mode:** Set the **`Generate from`** field to **`Prompt`** for text-to-3D, or **`Image`** to use a reference image.
4. **Provide Input:** Write a descriptive prompt or load a reference image.
5. *(Optional)* **Enable PBR:** Turn on **PBR generation** under *Advanced Parameters β Output & Material Settings* to produce physically-based material maps (roughness, metallic, normal).
6. **Generate:** Click the main **Generate** button and wait for the process to complete.
7. *(Optional)* **Refine the Result:** Adjust per-camera prompts and regenerate specific views, or switch to **Local Edit** mode (a preset is available) for targeted touch-ups.
**Exporting for a Game Engine:**
8. **Bake Textures:** You will most likely need to toggle UV unwrapping (within the `Bake Textures` operator) - the `Smart UV Project` mode works well in most cases.
9. **Export:** Use the built-in export tool `Export for Game Engine` or export manually from Blender.
---
## π Usage & Parameters Overview
StableGen provides a comprehensive interface for AI-powered 3D asset generation and texturing, from mesh creation to final PBR export. Here's an overview of the main sections and tools available in the StableGen panel:
### Primary Actions & Scene Setup
These are the main operational buttons and initial setup tools, generally found near the top of the StableGen panel:
* **Generate / Cancel Generation (Main Button):** Starts either 3D mesh generation (TRELLIS.2 pipeline) or texture generation for existing mesh objects, depending on the current mode. While processing, the button changes to "Cancel Generation." Progress bars (overall, phase, and per-step) appear below this button during generation.
* **Bake Textures:** Converts the dynamic, multi-projection material into a single, standard UV-mapped image texture per object. Also bakes PBR maps (albedo, roughness, metallic, normal, height, AO, emission) if PBR decomposition was enabled. Defaults to Smart UV Project unwrapping. Essential for exporting to game engines.
* **Add Cameras:** Set up multiple viewpoints using one of 7 placement strategies - from simple orbit rings to geometry-aware occlusion-optimized placement with per-camera aspect ratios. Use the interactive preview to fine-tune placement before confirming.
* **Collect Camera Prompts:** Cycles through all cameras in your scene, allowing you to type a specific descriptive text prompt for each viewpoint (e.g., "front view," "close-up on face"). These per-camera prompts are used in conjunction with the main prompt if `Use camera prompts` is enabled in `Viewpoint Blending Settings`.
### Preset Management
* Located prominently in the UI, this system allows you to:
* **Select a Preset:** Choose from 30+ built-in presets organized across 4 architecture groups (SDXL/FLUX.1, Qwen Image Edit, FLUX.2 Klein, TRELLIS.2 Pipeline), or select `Custom` to use your current settings.
* **Preset Diff Preview:** When hovering or selecting a preset, StableGen shows which parameters differ from your current settings and what they will change to.
* **Apply Preset:** If you modify a stock preset, this button applies its original values.
* **Save Preset / Delete Preset:** Save your current configuration as a named preset or remove a custom preset. ControlNet and LoRA include toggles let you choose what to save.
### Main Parameters
These are your primary controls for defining the generation:
* **Prompt:** The main text description of the texture (or 3D asset) you want to generate.
* **Checkpoint:** Select the base SDXL checkpoint (for SDXL/FLUX architectures).
* **Architecture:** Choose between `SDXL`, `Flux 1`, `Qwen Image Edit`, and `FLUX.2 Klein` (experimental) model architectures. For 3D mesh generation, use the TRELLIS.2 pipeline presets.
* **Generation Mode:** Defines the core strategy for texturing:
* `Generate Separately`: Each viewpoint generates independently.
* `Generate Sequentially`: Viewpoints generate one by one, using inpainting from previous views for consistency.
* `Generate Using Grid`: Combines all views into a grid for a single generation pass, with an optional refinement step.
* `Refine/Restyle Texture (Img2Img)`: Uses the current texture as input for an image-to-image process.
* `Local Edit`: Selectively modify specific areas by pointing cameras at them - new texture blends over the original with feathered edges.
* `UV Inpaint Missing Areas`: Fills untextured areas on a UV map via inpainting.
* **Target Objects:** Choose whether to texture all visible mesh objects or only selected ones.
### Advanced Parameters (Collapsible Sections)
Click the arrow next to each title to expand and access detailed settings:
* **Core Generation Settings:** Control diffusion basics like Seed, Steps, CFG, Negative Prompt, Sampler, Scheduler and Clip Skip.
* **LoRA Management:** Add and configure LoRAs (Low-Rank Adaptation) for additional style or content guidance. You can set the model and clip strength for each LoRA.
* **Viewpoint Blending Settings:** Manage how textures from different camera views are combined, including camera-specific prompts, discard angles, blending weight exponents, camera generation order, and post-generation exponent reset.
* **Output & Material Settings:** Define fallback color, material properties (BSDF), automatic resolution scaling, and options for baking textures during generation which enables generating with more than 8 viewpoints.
* **Image Guidance (IPAdapter & ControlNet):** Configure IPAdapter for style transfer using external images and set up multiple ControlNet units (Depth, Canny, etc.) for precise structural control.
* **Inpainting Options:** Fine-tune masking and blending for `Sequential` and `UV Inpaint` modes (e.g., differential diffusion, mask blurring/growing).
* **Generation Mode Specifics:** Parameters unique to the selected Generation Mode, like refinement options for Grid mode or IPAdapter consistency settings for Sequential/Separate/Refine modes.
* **PBR Decomposition:** Enable PBR material extraction after texturing. Toggle individual map types (albedo, roughness, metallic, normal, height, AO, emission), choose albedo source, and configure tiled super-resolution. Only shown when the required Marigold/StableDelight nodes are available on the server.
* **TRELLIS.2 Settings:** Configure 3D mesh generation - resolution mode, decimation, remeshing, import scale, shading mode, texture mode (Native/SDXL/FLUX/Qwen/Klein), preview gallery seed count, and camera placement strategy for texturing.
### Integrated Workflow Tools (Bottom Section)
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. *(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.
* **Convert Curves to Mesh:** Converts any selected curve objects into mesh objects, which is necessary before StableGen can texture them.
* **Export Orbit GIF/MP4:** Creates an animated GIF and MP4 of the active object with the camera orbiting around it. Configurable duration, FPS, resolution, render engine (Workbench/Eevee/Cycles), and HDRI environment modes.
* **Reproject Images:** Re-applies previously generated textures using the latest Viewpoint Blending Settings. Allows tweaking texture blending without full regeneration.
* **Mirror Reproject:** Mirrors the last projection camera and image across an axis, then reprojects. Useful for symmetric objects.
Experiment with these settings and tools to achieve a vast range of effects and control! Remember that the optimal parameters can vary greatly depending on the model, subject matter, and desired artistic style.
---
## π Output Directory Structure
StableGen organizes the generated files within the `Output Directory` specified in your addon preferences. For each generation session, a new timestamped folder is created, helping you keep track of different iterations. The structure for each session (revision) is as follows:
* `