StableGen README

The project's README from github.com/sakalond/StableGen. As one markdown file: README.md.

StableGen logo StableGen

Generate, texture and rig 3D assets in Blender.

License: GPL-3.0 Blender 4.2 to 4.5, or 5.1 and later Downloads Join the StableGen Discord server

Documentation · Installation · Quick start · Discussions · Discord · Releases

StableGen is a Blender add-on that textures meshes and whole scenes with diffusion models, and generates new meshes from a prompt or an image. It renders guidance images from cameras in your scene, sends the work to a ComfyUI server on the same computer or elsewhere on your network, and projects the results back onto the meshes.

A clay room textured in three interior styles: Scandinavian, spaceship and wizard's study

One prompt to a rigged asset

Describe a character and pick one of the preview images; StableGen does the rest in one run. TRELLIS.2 builds the mesh, SkinTokens rigs it, and views generated around it are projected into its texture. A run can also start from an image, skip the rig, or keep the texture TRELLIS.2 makes itself. TRELLIS.2

The StableGen panel: a prompt, the preview gallery, then the mesh, rig and texture generated in BlenderThe StableGen panel: a prompt, the preview gallery, then the mesh, rig and texture generated in Blender

What it does

Texture any model

Place cameras around one object or a whole scene. StableGen generates a view from each camera and projects it onto every surface that camera sees; each view is generated with the earlier ones as context, so the texture stays consistent all the way round. Generation modes · Cameras

A floating island textured view by view from ten generated camera viewsA floating island textured view by view from ten generated camera views

Edit part of a texture

Paint over the part you want to change and describe the change. Masked Edit regenerates only the painted region, in every view that sees it, and leaves the rest of the texture as it was. Masked Edit

A courier's yellow jacket replaced in turn by a black neon tech jacket, desert camo and a chrome racing jacketA courier's yellow jacket replaced in turn by a black neon tech jacket, desert camo and a chrome racing jacket

PBR materials

Marigold estimates albedo, roughness, metallic and normal maps from the generated views. StableGen projects them like the color and bakes them into standard maps for other software. PBR maps

A log house under a moving light, with its base color, roughness, metallic and normal mapsA log house under a moving light, with its base color, roughness, metallic and normal maps

Rig and animate

SkinTokens adds a skeleton and skin weights to a character, during a TRELLIS.2 run or on any mesh you select. Motion from FBX or BVH files, such as Mixamo animations, can then be retargeted onto the rig. Rigging and animation

A generated character with its skeleton, then walking with a retargeted Mixamo animationA generated character with its skeleton, then walking with a retargeted Mixamo animation

Export to a game engine

Bake the result, PBR maps included, into UV textures and export it with its rig and animations: glTF for Godot and the web, or FBX for Unreal Engine and Unity. Below, a village in Unreal Engine 5.7 built only from StableGen exports: the houses, props, trees and ground as GLB with PBR maps, and five rigged characters as FBX with their walk. Orbit GIFs and MP4s, multi-color 3MF files for 3D printing, and the scene queue for unattended batches are in the same place. Export · Batch processing

A village of StableGen assets in Unreal Engine 5.7: the level editor with the imported assets, then aerial, market, street and village shots with five walking charactersA village of StableGen assets in Unreal Engine 5.7: the level editor with the imported assets, then aerial, market, street and village shots with five walking characters

Working by hand

Each step can also be done by hand: reorder the cameras and give views their own prompts, change how the views blend and reproject without generating again, extract PBR maps, and repaint a region with Masked Edit.

The StableGen panel: camera order and view prompts, blending, PBR maps and Masked EditThe StableGen panel: camera order and view prompts, blending, PBR maps and Masked Edit

How it works

StableGen runs inside Blender and sends the model work to a ComfyUI server, on the same computer or another one on the network. You start from a prompt, an image or your own model, and the results come back into the scene as materials, meshes and armatures.

In Blender: prompt, mesh, cameras, projection, bake and export. On the ComfyUI server: mesh generation with TRELLIS.2, rigging with SkinTokens, diffusion with SDXL or Qwen Image, and PBR maps with Marigold.In Blender: prompt, mesh, cameras, projection, bake and export. On the ComfyUI server: mesh generation with TRELLIS.2, rigging with SkinTokens, diffusion with SDXL or Qwen Image, and PBR maps with Marigold.

Texturing works by projection. Each camera gets a generated view that follows the geometry through a depth guide, and the views are blended onto the surface by how directly each camera sees it.

Projection in three steps: place cameras, generate a view for each from a depth guide, project and blend the viewsProjection in three steps: place cameras, generate a view for each from a depth guide, project and blend the views

Built on

Inventor with goggles and a leather apron Wizard in purple and gold robes with a crystal staff Stone windmill with wooden sails Brass astrolabe Adventurer in steel armor Market stall with a striped awning and baskets of produce White mecha robot Treasure chest full of gold coins Mossy stone obelisk with glowing green runes Hollow tree stump with glowing mushrooms

Requirements

Installation

  1. Install ComfyUI and check that it runs.
  2. Install the custom nodes and models StableGen uses with the installer in this repository, then restart ComfyUI:
    python installer.py <path to ComfyUI>
    
    Package 3 sets up SDXL texturing, package 13 Qwen Image 2.1, package 8 mesh generation, package 14 auto-rigging, and packages 15 to 17 the experimental architectures.
  3. Download the add-on ZIP for your system (Windows x64, Linux x64 or macOS on Apple Silicon) from Releases. In Blender, open Edit > Preferences > Get Extensions, choose Install from Disk in the top-right menu, and select the ZIP.
  4. In the add-on preferences, set Output Directory and Server Address (127.0.0.1:8188 by default). Under System > Network, enable Allow Online Access.

Installation covers every installer package, unattended installs, a remote server and manual setup.

Quick start

Press N in the 3D Viewport and open the StableGen tab.

Texture a model

  1. Select the mesh and click Add cameras.
  2. Choose an Architecture and a Preset, then a Checkpoint on the Texture page.
  3. Describe the surface in Texture prompt and click Generate textures.
  4. Switch the viewport to Rendered shading to see the result. Bake and Export turn it into ordinary textures and files.

Generate an asset

  1. Set Architecture to TRELLIS.2 and choose a preset tagged Mesh + texture.
  2. On the Mesh page, set Generate mesh from to Prompt, describe the object and enable Preview gallery.
  3. To rig a character in the same run, enable Auto-rig under Rigging & Animation.
  4. Click Generate asset, then pick a preview image.

Quick start goes through both in detail.

Documentation

The StableGen wiki covers every feature in detail:

License

StableGen is released under the GNU General Public License v3.0. The models and nodes it runs on ComfyUI have their own licenses, and three of them are for non-commercial use only:

Acknowledgements

StableGen began as a bachelor's thesis by Ondřej Sakala at the Faculty of Information Technology, Czech Technical University in Prague, supervised by Ing. Radek Richtr, Ph.D. (full text). Part of its development took place during a study stay at Kanazawa University in summer 2026; travel costs were supported by a grant from Nadace „Nadání Josefa, Marie a Zdeňky Hlávkových“.

It builds on ComfyUI, ComfyUI-TRELLIS2 and Blender, and was inspired by the Dream Textures and Diffused Texture add-ons.

Research StableGen draws on

Contact

StableGen (sakalond/StableGen)

Searching Database…

Transform your 3D texturing workflow with the power of generative AI, directly within Blender!

Creator
sakalond
Size
479.4 MB
Stars
1.2K
Updated
PushOct 28
Age
1y
Commits · 90 Days