Chcete začít rychle tvořit 3D modely pomocí AI? Hunyuan3D-2 od Tencentu umožňuje generování 3D modelů s texturami během několika sekund. Díky platformě Pinokio je instalace jednoduchá a bezpečná. Postupujte podle následujících kroků:

Klíčové informace:

• Požadavky na hardware:
  • GPU s minimálně 11,5 GB VRAM (doporučeno 24,5 GB pro plné využití).
  • Windows 10 nebo novější, Python 3.11+, CUDA Toolkit 12.4+.
• Instalace Pinokio:
  • Stáhněte z oficiálního webu, nainstaluje i potřebné nástroje (Python, Anaconda, FFmpeg).
• Volba verze Hunyuan3D-2 podle VRAM:
  • Standardní (24 GB VRAM+)
  • LowVRAM (6 GB VRAM+)

Rychlý přehled:

Začněte instalací Pinokio, ověřte kompatibilitu GPU a postupujte podle návodu k instalaci Hunyuan3D-2. Problémy s pamětí nebo chybami DLL lze řešit přepnutím na LowVRAM verzi nebo aktualizací ovladačů. Po instalaci můžete snadno vytvářet 3D modely z textu, obrázků nebo skic.

Přípravné kroky před instalací

Před instalací Hunyuan3D-2 je potřeba připravit váš systém Windows. Správná příprava zajistí hladký průběh instalace i bezproblémový výkon.

Instalace Pinokio

• Stažení instalačního souboru
  Přejděte na oficiální web Pinokio a stáhněte aktuální verzi instalačního souboru. Pokud se během stahování objeví varování od Windows Defenderu, můžete jej ignorovat a pokračovat. Tento krok je běžný .
• Spuštění instalace
  Po otevření instalačního souboru vás aplikace Pinokio provede procesem instalace. Automaticky nainstaluje všechny potřebné nástroje, včetně správy GitHub repozitářů, FFmpeg, Pythonu, Anacondy a virtuálních prostředí.

Jakmile je Pinokio úspěšně nainstalováno, přejděte ke kontrole hardwarových požadavků na GPU.

Kontrola požadavků na GPU

Pro ověření kompatibility GPU postupujte podle následujících kroků:

• Správce zařízení (Windows + X):
  • Otevřete „Správce zařízení“ a rozbalte sekci „Grafické adaptéry“.
  • Zkontrolujte model grafické karty.
• Správce úloh (Ctrl + Shift + Esc):
  • Přejděte na záložku „Výkon“ a vyberte „GPU“.
  • Zkontrolujte dostupnou VRAM.

Pokud vaše GPU splňuje požadavky, přejděte k úpravě nastavení Windows pro AI.

Nastavení Windows pro AI

Před instalací nezapomeňte na tyto kroky:

• Stáhněte a nainstalujte Visual Studio Build Tools s volbou „Vývoj desktopových aplikací v C++“ .
• Aktualizujte ovladače grafické karty na nejnovější dostupnou verzi.
• Nainstalujte PyTorch kompatibilní s verzí CUDA, kterou používáte .

Průvodce instalací Hunyuan3D-2

Otevření skriptů v Pinokio

Po instalaci aplikace Pinokio a kontrole systémových požadavků postupujte podle těchto kroků:

1. Spuštění Pinokio: Otevřete aplikaci Pinokio. Slouží jako lokální prohlížeč pro správu serverových aplikací .
2. Vyhledání skriptu: Použijte vyhledávací pole v horní části okna a zadejte "Hunyuan3D-2".
3. Výběr verze: Zvolte verzi, která odpovídá VRAM vaší grafické karty:

Spuštění instalace

1. Zahájení instalace

Klikněte na tlačítko „Install“ u vybrané verze Hunyuan3D-2. Pinokio automaticky stáhne a nainstaluje všechny potřebné součásti .

2. Sledování průběhu

Sledujte průběh instalace v konzoli. Doba instalace závisí na rychlosti připojení. Pokud narazíte na problémy, pokračujte do sekce řešení chyb.

Řešení běžných chyb

Chyba načítání DLL souborů

"V únoru 2025 uživatel Vainilla07 hlásil chybu ImportError: DLL load failed while importing custom_rasterizer_kernel: Cannot find the specified module."

Zkontrolujte, zda máte nainstalované všechny požadované závislosti včetně Visual Studio Build Tools.

Problémy s pamětí CUDA

"V únoru 2025 uživatel sankexin nahlásil chybu 'cuda out of memory'."

• Přepněte na verzi LowVRAM.
• Snižte velikost textur.
• Zavřete ostatní aplikace, které využívají GPU.

Problémy s kompilací

"V únoru 2025 uživatel metamountain nahlásil chybu při kompilaci rasterizeru."

Řešení zahrnuje:

• Aktualizaci CUDA Toolkit na verzi 12.4 nebo novější.
• Přeinstalaci ovladačů NVIDIA.
• Kontrolu kompatibility verze Python.

Pokud problémy přetrvávají, zvažte využití komunitních nástrojů, jako jsou ComfyUI-Hunyuan3DWrapper nebo Hunyuan3D-2-for-windows .

sbb-itb-6f064b4

Nastavení a první spuštění

Po úspěšné instalaci je čas na konfiguraci systému a spuštění aplikace.

Nastavení cesty k souborům

Aby systém správně rozpoznal aplikaci Hunyuan3D-2, je potřeba nastavit cestu k její instalační složce v Systémových vlastnostech Windows:

• Klikněte pravým tlačítkem na "Tento počítač" a vyberte možnost "Vlastnosti".
• Přejděte do "Pokročilé nastavení systému".
• Otevřete "Proměnné prostředí".
• V sekci "Systémové proměnné" vyhledejte proměnnou "Path".
• Přidejte cestu k instalační složce Hunyuan3D-2.

Poznámka: Maximální délka proměnné prostředí je 1 024 znaků. Pokud je cesta příliš dlouhá, může být nutné upravit registr.

Pro ověření zadejte příkaz: echo %PATH%.

Výběr verze podle VRAM

Zvolte správnou verzi aplikace podle kapacity paměti vaší grafické karty. K ověření velikosti VRAM můžete použít nástroj GPU-Z.

První spuštění programu

Aplikaci Hunyuan3D-2 můžete spustit dvěma způsoby:

• Gradio rozhraní: Zadejte příkaz python3 gradio_app.py.
• API server: Zadejte příkaz python api_server.py --host 0.0.0.0 --port 8080.

Pro ověření instalace doporučujeme vytvořit jednoduchý 3D model z testovacího obrázku.

V lednu 2025 společnost Tencent zpřístupnila inferenční kód a předtrénované modely Hunyuan3D 2.0. Ty lze vyzkoušet prostřednictvím platformy Hugging Face Space nebo na jejich oficiálních stránkách.

Kontrolní body

Před dalším postupem zkontrolujte následující:

• Cesta v systémových proměnných byla nastavena správně.
• Vybraná verze odpovídá kapacitě vaší grafické karty.
• Připojení k internetu je funkční pro stažení potřebných modelů.

Po těchto krocích je instalace dokončena a můžete začít plnohodnotně pracovat s Hunyuan3D-2.

Výkon a řešení problémů

Optimalizace výkonu

Pro zajištění hladkého chodu Hunyuan3D-2 je důležité správné nastavení hardwaru a softwaru. Doporučené požadavky zahrnují aktualizované ovladače GPU, procesor s podporou AVX, 8–32 GB RAM a operační systém Windows 10 nebo novější.

Kromě základního nastavení můžete snížit nároky na VRAM úpravou určitých parametrů:

• tile_size v uzlu „VAE Decode (Tiled)“ – zmenšení hodnoty pro nižší spotřebu paměti.
• temporal_overlap – úprava pro efektivnější správu paměti.
• weight_dtype v uzlu „Load Diffusion Model“ – nastavení na fp8 pro úsporu VRAM.

Řešení běžných problémů

I při optimálním nastavení se mohou objevit potíže. Zde je několik tipů, jak je řešit:

ModuleNotFoundError

• Zkontrolujte, zda máte nejnovější verzi ComfyUI.
• Ověřte, že všechny soubory jsou umístěny ve správných složkách.

CUDA chyby

• Ujistěte se, že máte správně nainstalovanou CUDA a nastavené systémové proměnné.
• Používejte GPU s výpočetní schopností 6.0 nebo vyšší (např. Pascal).

Problémy s pamětí

• Aktivujte dlaždicování, aby se snížily nároky na VRAM, aniž by došlo ke ztrátě kvality výstupu.

Pokud nemáte k dispozici vhodnou GPU, pluginy strojového učení mohou běžet na CPU. Mějte však na paměti, že výkon bude výrazně nižší .

Kde hledat pomoc

Pro další informace a podporu můžete využít následující zdroje:

• Oficiální dokumentaci dostupnou na Hugging Face Space.
• Fóra ComfyUI s aktivní komunitou.
• Discord kanály, kde jsou vývojáři připraveni poradit.

Pro profesionální práci, například s 360VR nebo filmovými projekty, je doporučeno mít alespoň 8–32 GB RAM. Tím zajistíte plynulý výkon i při náročných úlohách .

Další kroky

Instalace je hotová, takže je čas se pustit do tvorby vlastních 3D modelů.

Začněte tím, že se seznámíte s prostředím Hunyuan3D-2. Program má přehledné a snadno pochopitelné rozhraní, které vám umožní pracovat s umělou inteligencí na tvorbě 3D modelů. Doporučujeme začít s jednoduššími objekty a postupně se pustit do složitějších projektů.

Tipy, jak z Hunyuan3D-2 vytěžit maximum:

• Připojte se na oficiální Discord komunitu, kde najdete tipy, rady a inspiraci.
• Podívejte se na rozšíření jako ComfyUI-3D-Pack a ComfyUI-Hunyuan3DWrapper, která vám mohou usnadnit práci.
• Navštivte oficiální web Hunyuan3D Studio a projděte si dostupné tutoriály a dokumentaci.

Vyzkoušejte také hybridní metody generování modelů, například kombinaci technik zigzag a boundary parallel. Tyto metody jsou ideální pro tvorbu složitějších 3D objektů.

Nezapomeňte pravidelně kontrolovat aktualizace na oficiálním GitHub repozitáři. Najdete tam nejen nové verze programu, ale také užitečné nástroje a doplňky, jako je například Blender Addon pro pokročilé modelování.

Tímto začíná vaše tvůrčí cesta s Hunyuan3D-2!