Repolode
Tencent-Hunyuan

Tencent-Hunyuan/Hunyuan-GameCraft-1.0

Modelo de código abierto para generar videos interactivos de juegos a partir de una imagen de referencia y controles de teclado o mouse.

Estrellas
760
Forks
78
Issues abiertos
19
Último commit
hace 11 meses

¿Qué es?

Hunyuan-GameCraft es un modelo de generación de video de Tencent Hunyuan, diseñado para crear metraje interactivo de juegos. A partir de una imagen de referencia, un prompt de texto y una secuencia de acciones de teclado o mouse, como W, A, S, D, el modelo genera un video que sigue esos movimientos de cámara. Las entradas del teclado y el mouse se convierten a un espacio compartido de representación de cámara para interpolar los movimientos con fluidez.

El proyecto está pensado para extender videos largos. Utiliza una estrategia de entrenamiento híbrida condicionada por el historial, que prolonga las secuencias de forma autorregresiva y conserva la información de la escena de los fotogramas anteriores. También incluye una variante destilada, que requiere 8 pasos de inferencia en lugar de 50 y admite FP8 para acelerar la generación.

El repositorio incluye scripts de inferencia para generar en paralelo con varias GPU en Linux con CUDA, un modo para una sola GPU y poca VRAM con descarga de tareas a la CPU, y una interfaz web de Gradio conectada a una API de inferencia distribuida. Los pesos del modelo están publicados en Hugging Face.

Funciones clave

  • 01Convierte las acciones de teclado y mouse a un espacio de cámara compartido para ofrecer un control preciso.
  • 02Extiende videos de forma autorregresiva mediante un condicionamiento híbrido basado en el historial.
  • 03Incluye un modelo destilado que solo requiere 8 pasos de inferencia.
  • 04Admite la optimización FP8 y SageAttention.
  • 05Ofrece un modo para una sola GPU y poca VRAM con descarga de tareas a la CPU.
  • 06Incluye una interfaz web de Gradio con una API de inferencia distribuida.

Casos de uso

  • Investigar la generación de video controlable y condicionada por acciones para juegos.
  • Crear prototipos de clips con estilo de juego a partir de una sola imagen conceptual y entradas de movimiento.
  • Experimentar con la extensión de videos de larga duración en servidores Linux con varias GPU.

Inicio rápido

  1. 1

    Clona el repositorio

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

    Crea el entorno de conda

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

    Instala PyTorch y las dependencias de pip

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

    Descarga los pesos del modelo preentrenado (consulta weights/README.md)

  5. 5

    Ejecuta la interfaz web de Gradio

    bash scripts/launch_app_sp.sh

Antes de usarlo

  • Requiere una GPU NVIDIA con CUDA; se necesitan al menos 24 GB de memoria de GPU y se recomiendan 80 GB.
  • Solo se ha probado en Linux.
  • La inferencia con poca VRAM es muy lenta.
  • El tiempo de inferencia aumenta de forma lineal con la longitud de la acción.

Temas

Preguntas frecuentes

¿Qué es Hunyuan-GameCraft-1.0?
Modelo de código abierto para generar videos interactivos de juegos a partir de una imagen de referencia y controles de teclado o mouse. Hunyuan-GameCraft es un modelo de generación de video de Tencent Hunyuan, diseñado para crear metraje interactivo de juegos. A partir de una imagen de referencia, un prompt de texto y una secuencia de acciones de teclado o mouse, como W, A, S, D, el modelo genera un video que sigue esos movimientos de cámara. Las entradas del teclado y el mouse se convierten a un espacio compartido de representación de cámara para interpolar los movimientos con fluidez.
¿Hunyuan-GameCraft-1.0 es gratuito? ¿Qué licencia tiene?
Hunyuan-GameCraft-1.0 es open source bajo la licencia Other. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿Hunyuan-GameCraft-1.0 sigue mantenido?
Sin commits en más de 6 meses. El último commit de Hunyuan-GameCraft-1.0 fue el 28 nov 2025.
¿Para qué puedo usar Hunyuan-GameCraft-1.0?
Investigar la generación de video controlable y condicionada por acciones para juegos. Crear prototipos de clips con estilo de juego a partir de una sola imagen conceptual y entradas de movimiento. Experimentar con la extensión de videos de larga duración en servidores Linux con varias GPU.
¿Cómo se instala Hunyuan-GameCraft-1.0?
Clona el repositorio: git clone https://github.com/Tencent-Hunyuan/Hunyuan-GameCraft-1.0.git Crea el entorno de conda: conda create -n HYGameCraft python==3.10 Instala PyTorch y las dependencias de pip: python -m pip install -r requirements.txt Descarga los pesos del modelo preentrenado (consulta weights/README.md) Ejecuta la interfaz web de Gradio: bash scripts/launch_app_sp.sh
¿Dónde consigo Hunyuan-GameCraft-1.0?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Tencent-Hunyuan/Hunyuan-GameCraft-1.0

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados