개요
TRELLIS.2 uses structured 3D latent representations to generate textured shapes. The repository includes the TRELLIS.2-4B checkpoint, an image-to-3D example and a separate path for texturing existing shapes. It can turn a concept image into an initial asset for inspection in a 3D editor. Game prototypes, product visualizations and research workflows should evaluate the exported geometry and materials against the target renderer’s requirements.
주요 기능
- Generates a 3D shape from a reference image.
- Uses a compact structured 3D representation.
- Targets objects with complex topology.
- Generates PBR materials and exports GLB assets.
- Includes a texturing example for existing shapes.
- Includes local web demos and training code.
요구 사항, 설치 및 빠른 시작
2. Run git clone -b main https://github.com/microsoft/TRELLIS.2.git --recursive.
3. Use setup.sh as documented to install the environment and required extensions.
4. Load Trellis2ImageTo3DPipeline from microsoft/TRELLIS.2-4B.
5. Follow example.py to generate a mesh from an image and export it as GLB.
6. Run python app.py for the image-to-3D interface; use example_texturing.py or app_texturing.py for texture workflows.
사용 정보
Implementation notes
A single image does not reveal every surface, so inspect occluded geometry. Exported GLB files default to OPAQUE mode; assets containing alpha data may require material adjustments in the destination software.
모델 호환성 및 사용 사례
Upstream currently documents testing on Linux and recommends CUDA 12.4. Some extensions need compilation. The stated 24GB hardware requirement does not eliminate memory differences between resolutions and tasks.
라이선스 및 위험 참고 사항
The model and code use MIT. Dependencies including nvdiffrast and nvdiffrec have separate license terms.