SK-Adapter is a lightweight adapter for skeleton-based structural control in native 3D generation. It adds explicit 3D skeleton control to TRELLIS by encoding joint coordinates and topology into learnable tokens and injecting them into the frozen 3D generation backbone through cross-attention.

This model repository contains the released SK-Adapter checkpoints:

SK-Adapter treats a 3D skeleton as a first-class control signal. Instead of relying only on text or image prompts, it conditions generation on joint positions and skeleton topology, allowing more precise control over the generated object's structure.

The adapter is inserted into the first TRELLIS stage, replacing the sparse-structure flow model during inference while keeping the TRELLIS generative pipeline intact. The downstream TRELLIS stages then produce 3D outputs such as Gaussian splatting files, GLB meshes when export succeeds, and rendered views.

Use SK-Adapter when you want to generate 3D assets whose coarse structure follows a specified skeleton.

Supported workflows:

This model is intended for research and creative 3D generation experiments. It is not intended for safety-critical, medical, legal, or engineering-grade structural design.

Clone and set up the code repository:

On Windows PowerShell:

The setup script creates a sk-adapter environment with Python 3.10 and installs the TRELLIS backend plus SK-Adapter dependencies.

Download the checkpoint files from this repository and point the inference config to the appropriate file.

For text-conditioned generation:

Run:

For image-conditioned generation:

Run:

Both pipelines support dataset ids through samples[].id. The text pipeline also supports custom samples[].skeleton plus samples[].prompt, and the image pipeline supports custom samples[].skeleton plus samples[].image.

This repository is released under the Apache 2.0 License.

The checkpoints depend on external models and third-party components, including TRELLIS and Anymate-related tooling. Please also review the licenses and terms of those dependencies.

If you find this work useful, please cite: