Install Instructions: Different steps needed on some Linux setups

[EliasVincent]

Hey there,

The Problem

when following the setup steps in Get Started with Hunyuan3D 2.0 when installing the differentiable renderer:

cd hy3dgen/texgen/differentiable_renderer
bash compile_mesh_painter.sh OR python3 setup.py install (on Windows)

with bash compile_mesh_painter.sh under Linux (Linux Mint 22), it will then compile a file called mesh_processor.cpython-312-x86_64-linux-gnu.so

However with this the gradio server won't launch, saying it's still missing .mesh_processor:

Traceback (most recent call last):
  File "/home/cat/hunyuan3d/gradio_app.py", line 14, in <module>
    from hy3dgen.texgen.differentiable_renderer import mesh_processor
  File "/home/cat/hunyuan3d/hy3dgen/texgen/__init__.py", line 26, in <module>
    from .pipelines import Hunyuan3DPaintPipeline, Hunyuan3DTexGenConfig
  File "/home/cat/hunyuan3d/hy3dgen/texgen/pipelines.py", line 33, in <module>
    from .differentiable_renderer.mesh_render import MeshRender
  File "/home/cat/hunyuan3d/hy3dgen/texgen/differentiable_renderer/mesh_render.py", line 38, in <module>
    from .mesh_processor import meshVerticeInpaint

A potential fix

A fix for this issue I found is that you simply have to rename the file to mesh_processor.so, meaning the file will be in hy3dgen/texgen/differentiable_renderer/mesh_processor.so.

After a pip install -e . in the root folder of the project, the gradio app launched just fine.

---

Anyone else had this issue? Just wanted to let people know in case they run into this issue as well, or if this is just some weird quirk with my setup before opening a request to change the install instructions.