Repolode
Tencent-Hunyuan

Tencent-Hunyuan/Hunyuan-GameCraft-1.0

Modelo open source de geração interativa de vídeos de jogos que transforma uma imagem de referência e comandos de teclado ou mouse em vídeos de gameplay controláveis.

Estrelas
760
Forks
78
Issues abertas
19
Último commit
há 11 meses

O que é?

Hunyuan-GameCraft é um modelo de geração de vídeo do Tencent Hunyuan voltado a cenas de jogos interativas. Com uma imagem de referência, um prompt de texto e uma sequência de ações de teclado ou mouse, como W, A, S, D, o modelo gera um vídeo que acompanha esses movimentos de câmera. Os comandos de teclado e mouse são mapeados para um espaço compartilhado de representação da câmera, permitindo interpolar movimentos com fluidez.

O projeto é voltado à extensão de vídeos longos. Ele usa uma estratégia híbrida de treinamento condicionada pelo histórico, que estende sequências de forma autoregressiva enquanto preserva as informações da cena de quadros anteriores. Também há uma variante destilada, que usa 8 etapas de inferência em vez de 50 e oferece suporte a FP8 para acelerar a geração.

O repositório inclui scripts de inferência para geração paralela em várias GPUs no Linux com CUDA, um modo para uma única GPU com pouca VRAM e offload para CPU, além de uma interface web Gradio conectada a uma API de inferência distribuída. Os pesos do modelo estão disponíveis no Hugging Face.

Recursos principais

  • 01Mapeia ações de teclado e mouse para um espaço compartilhado de câmera, permitindo controle detalhado.
  • 02Estende vídeos de forma autoregressiva usando condicionamento híbrido pelo histórico.
  • 03Oferece um modelo destilado que precisa de apenas 8 etapas de inferência.
  • 04Oferece otimização com FP8 e SageAttention.
  • 05Disponibiliza um modo para uma única GPU com pouca VRAM e offload para CPU.
  • 06Inclui uma interface web Gradio com uma API de inferência distribuída.

Casos de uso

  • Pesquisar geração de vídeos de jogos controlável e condicionada por ações.
  • Criar protótipos de clipes no estilo de jogos a partir de uma única imagem conceitual e comandos de movimento.
  • Experimentar a extensão de vídeos de longa duração em servidores Linux com várias GPUs.

Início rápido

  1. 1

    Clone o repositório

    git clone https://github.com/Tencent-Hunyuan/Hunyuan-GameCraft-1.0.git
  2. 2

    Crie o ambiente conda

    conda create -n HYGameCraft python==3.10
  3. 3

    Instale o PyTorch e as dependências do pip

    python -m pip install -r requirements.txt
  4. 4

    Baixe os pesos do modelo pré-treinado (consulte weights/README.md)

  5. 5

    Execute a interface web do Gradio

    bash scripts/launch_app_sp.sh

Antes de usar

  • Requer uma GPU NVIDIA com CUDA; são necessários pelo menos 24 GB de memória de GPU, e 80 GB são recomendados.
  • Testado apenas no Linux.
  • A inferência com pouca VRAM é muito lenta.
  • O tempo de inferência aumenta linearmente com o comprimento da ação.

Tópicos

Perguntas frequentes

O que é Hunyuan-GameCraft-1.0?
Modelo open source de geração interativa de vídeos de jogos que transforma uma imagem de referência e comandos de teclado ou mouse em vídeos de gameplay controláveis. Hunyuan-GameCraft é um modelo de geração de vídeo do Tencent Hunyuan voltado a cenas de jogos interativas. Com uma imagem de referência, um prompt de texto e uma sequência de ações de teclado ou mouse, como W, A, S, D, o modelo gera um vídeo que acompanha esses movimentos de câmera. Os comandos de teclado e mouse são mapeados para um espaço compartilhado de representação da câmera, permitindo interpolar movimentos com fluidez.
Hunyuan-GameCraft-1.0 é gratuito? Qual é a licença?
Hunyuan-GameCraft-1.0 é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.
Hunyuan-GameCraft-1.0 ainda é mantido?
Sem commits há mais de 6 meses. O último commit de Hunyuan-GameCraft-1.0 foi em 28 de nov. de 2025.
Para que posso usar Hunyuan-GameCraft-1.0?
Pesquisar geração de vídeos de jogos controlável e condicionada por ações. Criar protótipos de clipes no estilo de jogos a partir de uma única imagem conceitual e comandos de movimento. Experimentar a extensão de vídeos de longa duração em servidores Linux com várias GPUs.
Como instalar Hunyuan-GameCraft-1.0?
Clone o repositório: git clone https://github.com/Tencent-Hunyuan/Hunyuan-GameCraft-1.0.git Crie o ambiente conda: conda create -n HYGameCraft python==3.10 Instale o PyTorch e as dependências do pip: python -m pip install -r requirements.txt Baixe os pesos do modelo pré-treinado (consulte weights/README.md) Execute a interface web do Gradio: bash scripts/launch_app_sp.sh
Onde consigo Hunyuan-GameCraft-1.0?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Tencent-Hunyuan/Hunyuan-GameCraft-1.0

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

Projetos relacionados