sakalond/StableGen 是一个托管在 GitHub 上的开源项目，主要使用 Python 编写，采用 GNU General Public License v3.0 许可证，目前获得 1.6k 个 Star、163 次 Fork。
仓库全名
sakalond/StableGen
README 摘要
 StableGen Generate, texture and rig 3D assets in Blender. 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…
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.
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. Afterwards, LATO.2 can rebuild any mesh as low-poly topology, and Make Solid removes the hidden interior shells TRELLIS.2 meshes carry. TRELLIS.2
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
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
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
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
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
Working by hand
Each step can also be done by hand: reorder the cameras, give views their own prompts and describe objects once for every view that sees them, change how the views blend and reproject without generating again, extract PBR maps, and repaint a region with 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.
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.
Built on
ComfyUI runs every model, locally or on another machine.
TRELLIS.2 generates meshes, through ComfyUI’s own TRELLIS.2 nodes.
SDXL with ControlNet and IPAdapter, and Qwen Image, generate the texture views. MOSS-Image and Bria FIBO 2.0 are available as experimental architectures.
Blender 4.2 to 4.5, or 5.1 and later. Blender 5.0 is not supported.
ComfyUI: StableGen can install its own, use one you have, or connect to one on another machine. An NVIDIA GPU is preferred: about 8 GB of VRAM for SDXL, and 16 GB or more for Qwen Image.
Windows, Linux, or macOS on Apple Silicon.
10 GB to over 50 GB of disk space for models, depending on what you install, plus about 5 GB for StableGen’s own ComfyUI.
Installation
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.
Under System > Network, enable Allow Online Access.
Open the StableGen panel in the 3D Viewport’s sidebar (N). Its ComfyUI setup page opens the first time, and later under ••• > ComfyUI setup. Choose where ComfyUI comes from:
Install StableGen’s own: pick an install folder and press Install ComfyUI. StableGen sets up ComfyUI with its own Python and torch for your GPU, about 5 GB, then starts and stops it by itself. Tested on Windows so far.
Use my ComfyUI folder: a ComfyUI you already have (portable, git or Desktop install, or one that runs on your system Python). StableGen installs models into it and starts it when needed.
Connect to a server: a ComfyUI on another machine, at its server address. Install the models there with the installer (below).
Under Models on the same page, install what you need: SDXL or Qwen Image 2.1 for texturing, TRELLIS.2 for meshes, auto-rigging, PBR maps, LATO.2 and the experimental architectures. Each shows its download size; installs can be queued and removed, and an interrupted download resumes. When the selected architecture’s models are missing, an Install line under Architecture downloads them too.
Set Output Directory in the add-on preferences.
On a remote ComfyUI, or without Blender, run the installer on that machine and restart ComfyUI:
python installer.py <path to ComfyUI> --packages 3,8
Package 3 sets up SDXL texturing, package 13 Qwen Image 2.1, package 8 mesh generation, package 14 auto-rigging, packages 15 to 17 the experimental architectures, and package 18 LATO.2 low-poly remeshing. python installer.py --create-comfyui <folder> sets up StableGen’s own ComfyUI there.
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
Select the mesh and click Add cameras.
Choose an Architecture and a Preset, then a Checkpoint on the Texture page.
Describe the surface in Texture prompt and click Generate textures.
Switch the viewport to Rendered shading to see the result. Bake and Export turn it into ordinary textures and files.
Generate an asset
Set Architecture to TRELLIS.2 and choose a preset tagged Mesh + texture.
On the Mesh page, describe the object. Generate mesh from starts on Prompt, with the Preview gallery on.
To rig a character in the same run, enable Auto-rig under Rigging & Animation.
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:
Qwen Image 2.1 and Qwen Image 2.1 Turbo are released under the Qwen Research License. Qwen Image Edit and SDXL are not affected.
Bria FIBO 2.0 is released under CC BY-NC 4.0; commercial use needs an agreement with Bria.
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“.
StableGen
评论