Trellis.2 GGUF

April 23, 2026 · View on GitHub

Convert a single image into a 3D mesh in one pass, using the Trellis.2 GGUF model by Aero-Ex.


Basic workflow

Default workflow — image to mesh to textured mesh

The workflow above is the recommended starting point. It chains the two nodes back-to-back:

Example output — generated mesh with texture

  1. Generate Mesh — takes an image and produces a geometry-only GLB
  2. Texture Mesh — takes the same image and the generated mesh, and bakes textures onto it

Nodes

Generate Mesh

ParameterDescriptionDefault
imageInput image (any background — it will be removed)
pipelineQuality preset: fast (512), balanced (1024), high (1024 cascade), ultra (1536 cascade)balanced
quantizationGGUF quant level (Q4_K_M → Q8_0). Lower = less VRAM, less qualityQ5_K_M
ss_stepsSparse-structure diffusion steps25
slat_stepsShape SLaT diffusion steps25
foreground_ratioHow much of the frame the subject should fill (0–1)0.85
remesh_resolutionDual-contouring grid resolution for the output mesh256
seedReproducibility seed0

Output: geometry GLB (no texture)

Texture Mesh

ParameterDescriptionDefault
imageSame input image used for generation
meshGLB mesh to texture (from Generate Mesh)
texture_resolutionTexture map size in pixels1024
atlas_sizeUV atlas packing resolution2048
texture_stepsTexture diffusion steps12
guidance_strengthCFG guidance for texture diffusion3.0
foreground_ratioShould match the value used in Generate Mesh0.85
seedReproducibility seed0

Output: textured GLB


Model source

Weights: Aero-Ex/Trellis2-GGUF on HuggingFace