Packs à paiement unique dès 14,90 $

ComfyUI and TRELLIS.2: A Safe Local Setup Checklist (2026)

Jan 27, 2026
6 min de lecture

Try Our AI 3D Generator

Turn your images into downloadable 3D models for product shots, game assets, and fast prototyping.

Generate 3D Model

Important: The Wrapper Is Not the Upstream Project

Microsoft maintains TRELLIS.2. ComfyUI integrations are community projects with their own code, release cadence, installation steps, wheels, and security posture. They are not automatically reviewed or supported by Microsoft, ComfyUI, or trellis-2.com.

Do not paste old TRELLIS commands into a TRELLIS.2 environment. The model names, packages, setup flags, and output pipeline differ.

What the Official Repository Currently States

The official TRELLIS.2 README documents:

  • A 4B image-to-3D model using O-Voxel
  • Published 512³, 1024³, and 1536³ modes with PBR materials
  • Code verification on NVIDIA A100 and H100 GPUs
  • Conda as the recommended environment manager
  • Python 3.8 or later
  • CUDA tooling for packages compiled during setup
  • A default environment based on PyTorch 2.6.0 and CUDA 12.4
  • flash-attn by default, with an xformers alternative for unsupported GPUs

These requirements can change. Read the current upstream README and setup.sh --help at the commit you plan to install.

Microsoft's H100 timing table is a model benchmark on stated hardware, not evidence that a particular consumer GPU, operating system, or community node will fit memory or achieve the same speed.

Decide Whether Local Setup Is Appropriate

Local operation can improve code/data control and remove a per-job hosted credit, but it adds:

  • GPU and storage capacity planning
  • Dependency and CUDA compatibility work
  • Model-download provenance checks
  • Security review of custom nodes and binary wheels
  • Monitoring, upgrades, backups, and incident response
  • Electricity and operator time

If you only need to evaluate one image, a hosted 512 job is usually a smaller operational test. If you need sustained volume or internal integration, benchmark self-hosting with the real workload.

Safe Installation Order

1. Validate the official pipeline first

Clone the official repository recursively and use the setup command from its current README. As of this review, Microsoft documents a new Conda environment with the basic runtime and the packages needed for attention, rendering, mesh processing, O-Voxel, and sparse convolution.

Do not rely on a copied one-line command indefinitely. Pin the Git commit and record:

  • Operating system and driver
  • CUDA toolkit and CUDA_HOME
  • Python, PyTorch, and attention backend
  • TRELLIS.2 commit
  • Model repository and revision
  • Successful resolution and peak memory

Run the official example before adding ComfyUI. This separates an upstream compatibility problem from a wrapper problem.

2. Review the ComfyUI wrapper

For any community wrapper, inspect:

  • Repository owner, recent commits, issues, and release tags
  • Installation scripts and every downloaded binary wheel
  • Exact TRELLIS.2 commit or model revision it expects
  • Supported ComfyUI frontend/backend versions
  • Whether nodes execute shell commands or open network listeners
  • Where images, models, and outputs are stored
  • License compatibility

Examples of community work can be found through the ComfyUI registry or repositories such as visualbruno/ComfyUI-Trellis2. A link is not an endorsement; review the current project before installing.

Use a dedicated environment and never expose production API keys, payment secrets, or unrelated model credentials to a custom-node process.

3. Verify model weights

Follow the model link from Microsoft's repository, pin a revision, and record file hashes when deploying to more than one machine. Avoid re-uploaded archives whose source cannot be traced to the official project or model publisher.

4. Build the smallest workflow

A minimal conceptual graph is:

load image
  → preprocess image/mask
  → load official TRELLIS.2 components
  → image-to-shape at one resolution
  → shape-to-textured mesh
  → export GLB
  → inspect result

Node names and parameters depend on the wrapper version. Import a workflow only from a source you trust, then inspect every node before running it.

First Validation Run

  1. Use a small, non-sensitive image with one clear object.
  2. Start at the lowest supported resolution.
  3. Record runtime, peak GPU memory, host memory, and output path.
  4. Inspect the GLB from every side and verify material channels.
  5. Restart the process and repeat to expose initialization or cache assumptions.
  6. Test a controlled failure and confirm temporary files and GPU memory are released.

Do not call the setup production-ready after one successful sample.

Troubleshooting by Layer

CUDA or compiled-extension failure

Check driver/toolkit compatibility, CUDA_HOME, compiler output, and the exact package that failed. Use the official setup help instead of mixing wheels from another CUDA/Python combination.

Attention backend failure

The official README notes flash-attn as the default and xformers as an alternative for unsupported GPUs. Follow the current upstream instructions; do not install both randomly or claim a speed multiplier without measuring the exact environment.

Out-of-memory failure

Confirm the resolution and whether multiple model components remain loaded. Close unrelated GPU processes and capture peak allocation. A wrapper's “low VRAM” option is wrapper-specific and does not guarantee success.

Missing or incompatible nodes

Pin compatible ComfyUI and wrapper commits. Review the wrapper's issue tracker and migration notes. Updating ComfyUI, custom nodes, PyTorch, and CUDA simultaneously makes the cause harder to isolate.

Output differs from the hosted site

Compare model revision, resolution, preprocessing, random seed, texture settings, remesh/decimation, and export path. A community workflow and a hosted provider may not expose identical defaults.

Production Checklist

  • Official pipeline passes on the pinned environment.
  • Wrapper code and binary sources have been reviewed.
  • Model revision and hashes are recorded.
  • Sensitive inputs and outputs have a retention/deletion policy.
  • The service is isolated from unrelated secrets and networks.
  • Timeouts, concurrency, disk limits, and GPU recovery are tested.
  • Failed jobs do not leave unlimited temporary files or locked GPU memory.
  • Output acceptance and human-review criteria are documented.
  • License and input rights have been reviewed.
  • Upgrade and rollback steps are rehearsed.

When to Use the Hosted Workflow

Use the hosted generator when you want to validate the image-to-GLB result without taking responsibility for the GPU stack. Use local TRELLIS.2 when operational control or sustained usage justifies the setup and maintenance burden.

Open the official Microsoft repository

Run one hosted 512 test

TRELLIS.2 Editorial Team

Meshy Hermes Agent Plugin vs Trellis Mini $4.99 Inspect-First GLB

Oct 31, 2026

Meshy Hermes Agent Plugin vs Trellis Mini $4.99 Inspect-First GLB

Meshy Agent/plugin subscription path vs Trellis Mini $4.99/150cr for one 512³ inspect-first GLB. Independent host, not Microsoft. Verified 2026-10-31.

Meshy First-Month ~50% Off vs Trellis Mini $4.99 GLB

Oct 29, 2026

Meshy First-Month ~50% Off vs Trellis Mini $4.99 GLB

Meshy Pro shows ~$10 first month (~50% off). Trellis Mini is $4.99/150cr = one 512³ inspect-first GLB. Independent host, not Microsoft. Confirm checkout.

Print-Ready from Chat (Meshy Agent) vs Inspect-First $4.99 GLB

Oct 27, 2026

Print-Ready from Chat (Meshy Agent) vs Inspect-First $4.99 GLB

Meshy Agent print-ready chat vs inspect-first Mini $4.99/150cr = one 512³ GLB on trellis-2.com. Independent host, not Microsoft. Checklist before slicer.

When You Don’t Need a 3D Agent: First Accepted GLB Checklist

Oct 27, 2026

When You Don’t Need a 3D Agent: First Accepted GLB Checklist

Skip Meshy Agent chat when one photo → one inspectable GLB. Mini $4.99/150cr = one 512³ on trellis-2.com. Independent host, not Microsoft. Checklist first.

Hosted TRELLIS.2 vs Meshy Subscription: Cost Per Accepted GLB

Oct 26, 2026

Hosted TRELLIS.2 vs Meshy Subscription: Cost Per Accepted GLB

One-time never-expire credits on trellis-2.com (150/300/500 per resolution) vs Meshy monthly pools. Compare cost per accepted GLB — independent host, not Microsoft.

Best Free Online 3D Viewers in 2026: GLB, STL, OBJ, FBX

Oct 8, 2026

Best Free Online 3D Viewers in 2026: GLB, STL, OBJ, FBX

Six free ways to open a 3D file without installing much, compared on formats, upload, sign-in and limits, including the TRELLIS.2 browser viewer online.

How to Check a 3D Mesh Before Printing

Oct 4, 2026

How to Check a 3D Mesh Before Printing

Check a generated mesh in the browser before you convert it to STL and send it to a slicer. Catch holes, flipped normals and thin walls early on.

Convert a GLB Draft to STL in the Browser

Oct 4, 2026

Convert a GLB Draft to STL in the Browser

Convert a GLB draft to STL in the browser, see which data you keep, and check the triangles before a slicer so thin walls do not surprise you later.

How to Open a 3MF File in the Browser

Oct 4, 2026

How to Open a 3MF File in the Browser

Open a 3MF package in the browser, orbit the mesh, and check what the file does and does not carry before a separate print step or slicer import run.

How to Open an FBX File in the Browser

Oct 4, 2026

How to Open an FBX File in the Browser

Drop an FBX file in the browser, orbit the mesh, and see which scene data the preview does and does not show before you convert or edit it elsewhere.

How to Open a GLB File in the Browser

Oct 4, 2026

How to Open a GLB File in the Browser

Open a GLB file online, including the textured draft this site downloads from one image, and check the estimated sides before you convert or print it.

How to Open a glTF File in the Browser

Oct 4, 2026

How to Open a glTF File in the Browser

Open a glTF file in the browser, and see why a lone JSON file fails when the buffer or textures were left behind so you can fix the package first.

How to Open an OBJ File in the Browser

Oct 4, 2026

How to Open an OBJ File in the Browser

Open an OBJ file in the browser, see the mesh without its sidecar materials, and know when to convert from a GLB so textures stay with the draft file.

How to Open a PLY File in the Browser

Oct 4, 2026

How to Open a PLY File in the Browser

Open a PLY mesh or scan in the browser, including vertex color, and see what a points-only file will not show before you convert or rebuild topology.

How to Open an STL File in the Browser

Oct 4, 2026

How to Open an STL File in the Browser

View an STL file online, orbit the triangles, and see why the preview has no color and no print profile before you send the mesh into a slicer tool.

How to Turn a Photo into a 3D Model

Oct 4, 2026

How to Turn a Photo into a 3D Model

Turn one photo into a downloadable GLB draft, then inspect the estimated sides before you convert or print so thin walls and holes show up early on.

Open-Source 3D AI in 2026: A Verification-First Guide

Jan 27, 2026

Open-Source 3D AI in 2026: A Verification-First Guide

Compare hosted trials and open-source image-to-3D models without invented rankings, then check current TRELLIS.2 facts and a cost-per-accepted-asset test.

ComfyUI and TRELLIS.2: A Safe Local Setup Checklist (2026)

Jan 27, 2026

ComfyUI and TRELLIS.2: A Safe Local Setup Checklist (2026)

Official TRELLIS.2 requirements, ComfyUI wrapper limits, install safety, model checks, workflow layout and troubleshooting for local image-to-3D.

Open-Source Image-to-3D: TRELLIS.2 vs Hunyuan3D, TripoSR

Jan 27, 2026

Open-Source Image-to-3D: TRELLIS.2 vs Hunyuan3D, TripoSR

Source-based review of open-weight image-to-3D releases you can run yourself: TRELLIS.2, Hunyuan3D 2.1, TripoSR and Stable Fast 3D, licences included.

TRELLIS.2 to Blender: Import GLB, Inspect, Clean, and Export

Jan 27, 2026

TRELLIS.2 to Blender: Import GLB, Inspect, Clean, and Export

A practical TRELLIS.2-to-Blender workflow for importing the hosted GLB, checking transforms, geometry and PBR materials, then exporting the scene.

TRELLIS.2 Tutorial: From One Image to a Reviewed GLB

Jan 27, 2026

TRELLIS.2 Tutorial: From One Image to a Reviewed GLB

Step-by-step TRELLIS.2 guide: input selection, 512/1024/1536 credit cost, tracked generation, GLB inspection, failure refunds and destination checks.

Can TRELLIS.2 Models Be 3D Printed? Mesh Validation

Jan 27, 2026

Can TRELLIS.2 Models Be 3D Printed? Mesh Validation

A practical TRELLIS.2 print-readiness workflow: manifoldness, holes, normals, wall thickness, scale, STL conversion, slicing and small test prints.

TRELLIS.2 in a VFX Pipeline: An Evaluation Checklist

Jan 27, 2026

TRELLIS.2 in a VFX Pipeline: An Evaluation Checklist

A transparent workflow for evaluating TRELLIS.2 output for VFX, previs, set dressing, and production handoff, without any fabricated artist testimonials.

Trellis 2 Quickstart: Your First Image-to-3D Draft

Jan 27, 2026

Trellis 2 Quickstart: Your First Image-to-3D Draft

A truthful five-minute TRELLIS.2 quickstart: sign in, buy credits, start a 512 job, follow live job status, inspect the result, and download a GLB draft.

TRELLIS.2 (trellis-2) Guide: Image-to-3D, PBR, GLB

Dec 18, 2025

TRELLIS.2 (trellis-2) Guide: Image-to-3D, PBR, GLB

A practical trellis-2 / trellis 2 / trellis.2 guide: what TRELLIS.2 is, how image-to-3D works, best inputs, key settings, and how to export/import GLB assets.

← Swipe →
ComfyUI and TRELLIS.2: A Safe Local Setup Checklist (2026)