Setting Up Trellis on Windows

[wes-kay]

I fully understand this is not an issue, just making a thread in the event that someone has a working setup with windows, the current dependencies are failing on the Microsoft C++ runtime on WSL and all the other ways I've tried to set Trellis up with.

This is above my pay grade, so if anyone wants to update with their working steps, I would appreciate it.

[bezo97]

I've spent a few hours trying to make the project run on WSL and it works.
Here's everything that worked for me beyond following the instructions:

• I used Ubuntu 24.04.1 LTS
• Must install gcc-11 and g++-11 and then symlink both with the below commands. You need to hunt these down from archives if you're also on the latest ubuntu. This step is needed to build the diffoctreerast project. It won't work with the latest gcc versions because gcc-11 is the maximum version that cuda 11.8 supports.
  • sudo ln -s /usr/bin/gcc-11 /usr/bin/gcc
  • sudo ln -s /usr/bin/g++-11 /usr/bin/g++
• missing GLIBCXX_3.4.32 caused a runtime error in diff_gaussian_rasterization - I solved this by creating a 3rd symlink: ln -sf /usr/lib/x86_64-linux-gnu/libstdc++.so.6 ${CONDA_PREFIX}/lib/libstdc++.so.6
  The rest should work as in the instructions.

Tagging @JeffreyXiang to confirm it runs in WSL with a bit of fiddling.

[sicxu]

Another solution to run the inference code on Windows.

git clone --recurse-submodules https://github.com/microsoft/TRELLIS.git
cd TRELLIS
conda create -n trellis python=3.10
conda activate trellis 

pip install torch==2.5.1 torchvision --index-url=https://download.pytorch.org/whl/cu124
pip install xformers==0.0.28.post3 --index-url=https://download.pytorch.org/whl/cu124
pip install pillow imageio imageio-ffmpeg tqdm easydict opencv-python-headless scipy ninja rembg onnxruntime trimesh xatlas pyvista pymeshfix igraph transformers
pip install git+https://github.com/EasternJournalist/utils3d.git@9a4eb15e4021b67b12c460c7057d642626897ec8
pip install https://github.com/bdashore3/flash-attention/releases/download/v2.7.1.post1/flash_attn-2.7.1.post1+cu124torch2.5.1cxx11abiFALSE-cp310-cp310-win_amd64.whl
pip install kaolin -f https://nvidia-kaolin.s3.us-east-2.amazonaws.com/torch-2.5.1_cu124.html

git clone https://github.com/NVlabs/nvdiffrast.git ./tmp/extensions/nvdiffrast
pip install ./tmp/extensions/nvdiffrast

git clone --recurse-submodules https://github.com/JeffreyXiang/diffoctreerast.git ./tmp/extensions/diffoctreerast
pip install ./tmp/extensions/diffoctreerast

git clone https://github.com/autonomousvision/mip-splatting.git ./tmp/extensions/mip-splatting
pip install ./tmp/extensions/mip-splatting/submodules/diff-gaussian-rasterization/

cp -r ./extensions/vox2seq ./tmp/extensions/vox2seq
pip install ./tmp/extensions/vox2seq

pip install spconv-cu120
pip install gradio==4.44.1 gradio_litmodel3d==0.0.1

set ATTN_BACKEND=flash-attn
set SPCONV_ALGO=native
python ./app.py

Originally posted by @iiiytn1k in #8

[sicxu]

Another example to run the inference code on Windows. #10

[SoftologyPro]

Can anyone share a WHL for diffoctreerast?
I am having issues getting past that point in the installs.

[iiiytn1k]

@SoftologyPro https://github.com/iiiytn1k/sd-webui-some-stuff/releases/download/diffoctreerast/diffoctreerast-0.0.0-cp310-cp310-win_amd64.whl

[SoftologyPro]

@SoftologyPro https://github.com/iiiytn1k/sd-webui-some-stuff/releases/download/diffoctreerast/diffoctreerast-0.0.0-cp310-cp310-win_amd64.whl

Thanks! That works. Any chance you have a WHL for mip-splatting.git too? That has the same build errors here (says no torch when torch is installed). The rest of the packages install fine.

[iiiytn1k]

@SoftologyPro There are wheels that built from source https://github.com/iiiytn1k/sd-webui-some-stuff/releases/tag/diffoctreerast

[VladRez]

I successfully got Trellis working on Windows 10 without requiring WSL, using Anaconda and CUDA compilation tools release 12.4.

The following command sequence replicates the setup.sh script in an Anaconda PowerShell prompt, using the parameters --new-env --basic --xformers --flash-attn --diffoctreerast --spconv --mipgaussian --kaolin --nvdiffrast.

conda create -n trellis python=3.10 -y
conda activate trellis
conda install pytorch==2.5.0 torchvision==0.20.0 pytorch-cuda=12.4 -c pytorch -c nvidia -y
pip install pillow imageio imageio-ffmpeg tqdm easydict opencv-python-headless scipy ninja rembg onnxruntime trimesh xatlas pyvista pymeshfix igraph transformers
pip install git+https://github.com/EasternJournalist/utils3d.git@9a4eb15e4021b67b12c460c7057d642626897ec8
pip install xformers==0.0.28.post2 --index-url https://download.pytorch.org/whl/cu124
# this will take 2hr+ to compile
pip install flash-attn
New-Item -ItemType Directory -Force -Path C:\tmp\extensions
git clone --recurse-submodules https://github.com/JeffreyXiang/diffoctreerast.git C:\tmp\extensions\diffoctreerast
pip install C:\tmp\extensions\diffoctreerast
pip install spconv-cu120
git clone https://github.com/autonomousvision/mip-splatting.git C:\tmp\extensions\mip-splatting
pip install C:\tmp\extensions\mip-splatting\submodules\diff-gaussian-rasterization\
pip install kaolin -f https://nvidia-kaolin.s3.us-east-2.amazonaws.com/torch-2.4.0_cu121.html
git clone https://github.com/NVlabs/nvdiffrast.git C:\tmp\extensions\nvdiffrast
pip install C:\tmp\extensions\nvdiffrast

In a DataSpell notebook I was able to generate

[dexb1e]

I've spent a few hours trying to make the project run on WSL and it works. Here's everything that worked for me beyond following the instructions:

• I used Ubuntu 24.04.1 LTS

• Must install gcc-11 and g++-11 and then symlink both with the below commands. You need to hunt these down from archives if you're also on the latest ubuntu. This step is needed to build the diffoctreerast project. It won't work with the latest gcc versions because gcc-11 is the maximum version that cuda 11.8 supports.

  • sudo ln -s /usr/bin/gcc-11 /usr/bin/gcc
  • sudo ln -s /usr/bin/g++-11 /usr/bin/g++

• missing GLIBCXX_3.4.32 caused a runtime error in diff_gaussian_rasterization - I solved this by creating a 3rd symlink: ln -sf /usr/lib/x86_64-linux-gnu/libstdc++.so.6 ${CONDA_PREFIX}/lib/libstdc++.so.6
  The rest should work as in the instructions.

Tagging @JeffreyXiang to confirm it runs in WSL with a bit of fiddling.

@bezo97 I managed to run the app.py demo with the following commands on WSL2 version 2.3.26 running Ubuntu 24.04.1 with Miniconda installed:

git clone --recurse-submodules https://github.com/microsoft/TRELLIS.git
cd TRELLIS
conda create -n trellis python=3.10
conda activate trellis
conda install cuda -c nvidia/label/cuda-11.8.0
conda install pytorch=2.4.0 torchvision torchaudio pytorch-cuda=11.8 -c pytorch -c nvidia
conda install gxx_linux-64
./setup.sh --basic --xformers --flash-attn --diffoctreerast --spconv --vox2seq --mipgaussian --kaolin --nvdiffrast --demo

PyTorch was pinned to 2.4.0 since it was the maximum version supported in this repo's setup.sh at the moment of writing. I added the "conda install gxx_linux-64" command since at some point during installation it failed to find the CPP compiler in the Conda environment. It installed GCC 11 confined to the Conda environment, so perhaps that would solve the issues you had with the GCC compiler version without needing to change the default system-wide version. I did not run into the GLIBCXX error.

[SoftologyPro]

Here are my install.bat and run.bat for installing on Windows 11 without WSL and/or Conda required. It does need CUDA 12 and will not work with the IoT LTSC version of Windows 11.

Create an empty directory. Save the 2 batch files into it. Command line into the directory. Run install.bat then run.bat.

The only issue this has is it only works on a 4090 GPU? On a 3090 it gives an out of memory error. Which is not correct as there is plenty of VRAM and physical RAM free. It installs fine and the UI starts fine. But when you click Generate it will OOM if you do not have a 4090. I have never seen any AI/ML script that works only on a 4090 and not a 3090. If anyone has any ideas as to why this happens, please let me know. Maybe the WHLs have some 4090 only compatible code?

install.bat

@echo off

cd
echo *** Deleting TRELLIS directory if it exists
if exist TRELLIS\. rd /S /Q TRELLIS

echo *** Cloning TRELLIS repository
git clone --recurse-submodules https://github.com/microsoft/TRELLIS.git
cd TRELLIS

echo *** Creating venv
python -m venv venv
call venv\scripts\activate.bat

echo *** Upgrading pip
python -m pip install --upgrade pip

echo *** Installing requirements
pip install torch==2.5.1 torchvision --index-url=https://download.pytorch.org/whl/cu124
pip install xformers==0.0.28.post3 --index-url=https://download.pytorch.org/whl/cu124
pip install pillow imageio imageio-ffmpeg tqdm easydict opencv-python-headless scipy ninja rembg onnxruntime trimesh xatlas pyvista pymeshfix igraph transformers
pip install git+https://github.com/EasternJournalist/utils3d.git@9a4eb15e4021b67b12c460c7057d642626897ec8
pip install https://github.com/bdashore3/flash-attention/releases/download/v2.7.1.post1/flash_attn-2.7.1.post1+cu124torch2.5.1cxx11abiFALSE-cp310-cp310-win_amd64.whl
pip install kaolin -f https://nvidia-kaolin.s3.us-east-2.amazonaws.com/torch-2.5.1_cu124.html
pip install https://github.com/iiiytn1k/sd-webui-some-stuff/releases/download/diffoctreerast/nvdiffrast-0.3.3-py3-none-any.whl
pip install https://github.com/iiiytn1k/sd-webui-some-stuff/releases/download/diffoctreerast/diffoctreerast-0.0.0-cp310-cp310-win_amd64.whl
pip install https://github.com/iiiytn1k/sd-webui-some-stuff/releases/download/diffoctreerast/diff_gaussian_rasterization-0.0.0-cp310-cp310-win_amd64.whl
pip install https://github.com/iiiytn1k/sd-webui-some-stuff/releases/download/diffoctreerast/vox2seq-0.0.0-cp310-cp310-win_amd64.whl
pip install spconv-cu120
pip install gradio==4.44.1 gradio_litmodel3d==0.0.1

call venv\scripts\deactivate.bat
cd..

echo *** Finished TRELLIS install
echo.
echo *** Scroll up and check for errors.  Do not assume it worked.
pause

run.bat

@echo off
cd TRELLIS
call venv\scripts\activate.bat
set ATTN_BACKEND=flash-attn
set SPCONV_ALGO=native
python app.py
call venv\scripts\deactivate.bat
cd..

[OneOnlineShow]

Here are my install.bat and run.bat for installing on Windows without WSL and/or Conda required. It does need CUDA 12.

ERROR: flash_attn-2.7.1.post1+cu124torch2.5.1cxx11abiFALSE-cp310-cp310-win_amd64.whl is not a supported wheel on this platform.
ERROR: diffoctreerast-0.0.0-cp310-cp310-win_amd64.whl is not a supported wheel on this platform.
ERROR: diff_gaussian_rasterization-0.0.0-cp310-cp310-win_amd64.whl is not a supported wheel on this platform.
ERROR: vox2seq-0.0.0-cp310-cp310-win_amd64.whl is not a supported wheel on this platform.

Windows 11 IoT LTSC.