【ローカルAI】Hunyuan3D 2をWindowsにインストールする

Hunyuan3D 2をWindowsにインストールして1枚のPNG画像から3Dモデルを作りたい！

概要

今回の記事では、Hunyuan3D 2をWindowsにインストールする手順を掲載する。

オリジナルのテンセントのバージョンは私の環境ではまともに動きそうになかったので

GitHub - Tencent-Hunyuan/Hunyuan3D-2: High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.

High-Resolution 3D Assets Generation with Large Scale Hunyua?

こちらのWindows向けの省VRAM版のバージョンをインストールした。

GitHub - YanWenKun/Hunyuan3D-2-WinPortable: 📦A portable package for running Hunyuan3D-2 on Windows. | 混元 3D 2.0 整合包

📦A portable package for running Hunyuan3D-2 on Windows. | 混元?

仕様書

環境

Microsoft Windows [Version 10.0.26100.3915]
CUDA 12.8
Python 3.11.5

手順書

下記のページからHunyuan3D2_WinPortable.7zをダウンロードして展開する。

Release 2025/03/27 · YanWenKun/Hunyuan3D-2-WinPortable

README | 中文说明 Release for MV. Major updates included, and a ?

D:\Hunyuan3D2_WinPortableに展開したとして話を進める。

Hunyuan3D2_WinPortableの中にある0-initialize.batを実行する。

完了すると他のbatファイルが作成される。

2-download-models.batを実行する。モデルのダウンロードが始まる。19GBほどの容量。

3-start.batを実行するとサーバーが立ち上がるのでブラウザでアクセスする。

この時点では形状の生成されてテクスチャは生成されない。

テクスチャも生成されるようにする

テクスチャを生成するにはCUDA Toolkit 12.8.1とVisual Studio Build Tools 2022が必要だ。
また、この処理をすると要求されるVRAMの容量が増加するので注意。

CUDA Toolkit 12.8.1は下記からダウンロードしてインストールする。

CUDA Toolkit 12.8 Update 1 Downloads

「Libraries」と「Compilers」にチェックを入れてインストールする。

Visual Studio Build Tools 2022は下記からダウンロードしてインストールする。（Visual Studioそのものでも可）

ワークロードにある「C++によるデスクトップの開発」にチェックを入れてインストールする。

C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Visual Studio 2022\Visual Studio Tools\VCにx64 Native Tools Command Prompt for VS 2022というショートカットがあるので、これを右クリックして「管理者として実行」を選択する。

Hunyuan3D2_WinPortableに移動する。

cd /d D:\Hunyuan3D2_WinPortable

環境変数をセットする。

set DISTUTILS_USE_SDK=1

1-compile-install-texture-gen.batを実行する。

3-start.batを実行するとサーバーが立ち上がるのでブラウザでアクセスする。

形状とテクスチャが生成されるようになってる。

まとめ（感想文）

後発っていうのもあるんだけども、TripoSRより出力の結果が良い気がする。