Repolode
YanWenKun

YanWenKun/Hunyuan3D-2-WinPortable

Pacote portátil para Windows que reúne o app web Gradio de conversão de imagem em 3D do Hunyuan3D 2.0/2.1, sem exigir configuração manual.

Estrelas
1,357
Forks
129
Issues abertas
52
Último commit
há 11 meses

O que é?

Este projeto reúne os apps web Gradio do Hunyuan3D 2.0 e 2.1, da Tencent, em um pacote pronto para executar no Windows. Basta extrair o arquivo, iniciar o launcher e abrir uma página local no navegador para gerar malhas 3D a partir de imagens ou texto, com geração opcional de texturas.

O pacote integra o mmgp, do projeto Hunyuan3D-2GP, que aplica offloading de VRAM e otimizações para executar os modelos em GPUs NVIDIA de uso doméstico. Há pastas separadas para o modelo 2.0 com otimizações do mmgp, o código oficial da versão 2.0 sem essas otimizações, o modelo 2.1 e os modos de API. Os arquivos dos modelos são baixados sob demanda durante a inicialização.

O pacote é voltado a GPUs NVIDIA e oferece builds para CUDA 12.9 ou 12.6; também exige um driver recente. Para gerar texturas, é preciso ter o CUDA Toolkit e o Visual Studio Build Tools 2022 instalados no sistema.

Recursos principais

  • 01Executa os apps web Gradio do Hunyuan3D 2.0 e 2.1 no Windows sem configuração manual do ambiente.
  • 02Gera malhas 3D a partir de imagens e oferece geração opcional de texturas.
  • 03Inclui otimizações de VRAM do mmgp para executar os modelos em GPUs NVIDIA de uso doméstico.
  • 04Oferece builds separados para CUDA 12.9 e CUDA 12.6, compatíveis com diferentes arquiteturas de GPU.
  • 05Baixa os arquivos dos modelos sob demanda e permite atualizá-los com UPDATE.bat.

Casos de uso

  • Gerar malhas 3D a partir de imagens de referência em um PC local com Windows e GPU NVIDIA.
  • Experimentar o Hunyuan3D 2.0 ou 2.1 sem montar o ambiente Python a partir do código-fonte.
  • Executar o Hunyuan3D em GPUs com pouca VRAM usando o offloading do mmgp.

Tópicos

Perguntas frequentes

O que é Hunyuan3D-2-WinPortable?
Pacote portátil para Windows que reúne o app web Gradio de conversão de imagem em 3D do Hunyuan3D 2.0/2.1, sem exigir configuração manual. Este projeto reúne os apps web Gradio do Hunyuan3D 2.0 e 2.1, da Tencent, em um pacote pronto para executar no Windows. Basta extrair o arquivo, iniciar o launcher e abrir uma página local no navegador para gerar malhas 3D a partir de imagens ou texto, com geração opcional de texturas.
Hunyuan3D-2-WinPortable é gratuito? Qual é a licença?
Hunyuan3D-2-WinPortable é open source sob a licença GPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
Hunyuan3D-2-WinPortable ainda é mantido?
Sem commits há mais de 6 meses. O último commit de Hunyuan3D-2-WinPortable foi em 19 de nov. de 2025.
Para que posso usar Hunyuan3D-2-WinPortable?
Gerar malhas 3D a partir de imagens de referência em um PC local com Windows e GPU NVIDIA. Experimentar o Hunyuan3D 2.0 ou 2.1 sem montar o ambiente Python a partir do código-fonte. Executar o Hunyuan3D em GPUs com pouca VRAM usando o offloading do mmgp.
Onde consigo Hunyuan3D-2-WinPortable?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/YanWenKun/Hunyuan3D-2-WinPortable

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados