Repolode
Tencent-Hunyuan

Tencent-Hunyuan/Hunyuan-GameCraft-1.0

Открытая модель для создания интерактивных игровых видео: она превращает референсное изображение и ввод с клавиатуры или мыши в управляемый геймплейный ролик.

Звёзды
760
Форки
78
Открытые issues
19
Последний коммит
11 месяцев назад

Что это?

Hunyuan-GameCraft — модель генерации видео от Tencent Hunyuan, предназначенная для создания интерактивных игровых роликов. На вход подаются референсное изображение, текстовый промпт и последовательность действий с клавиатуры или мыши, например W, A, S, D. Модель создаёт видео, в котором камера движется согласно этим действиям. Ввод с клавиатуры и мыши преобразуется в общее пространство представления камеры, благодаря чему движения можно плавно интерполировать.

Проект рассчитан на продолжение длинных видео. Для этого используется гибридная стратегия обучения с учётом истории: последовательность авторегрессионно расширяется, а информация о сцене из предыдущих кадров сохраняется. Также доступна дистиллированная версия: ей нужно 8 шагов инференса вместо 50, и она поддерживает FP8 для ускорения генерации.

В репозитории есть скрипты для параллельной генерации на нескольких GPU в Linux с CUDA, режим для одной GPU с небольшим объёмом видеопамяти и выгрузкой вычислений на CPU, а также веб-интерфейс Gradio, работающий через распределённый API инференса. Веса модели опубликованы на Hugging Face.

Ключевые возможности

  • 01Преобразует действия с клавиатуры и мыши в общее пространство камеры для точного управления.
  • 02Авторегрессионно продолжает видео с использованием гибридного учёта истории.
  • 03Предоставляет дистиллированную модель, которой достаточно 8 шагов инференса.
  • 04Поддерживает оптимизацию FP8 и SageAttention.
  • 05Предлагает режим для одной GPU с небольшим объёмом видеопамяти и выгрузкой вычислений на CPU.
  • 06Включает веб-интерфейс Gradio с распределённым API инференса.

Сценарии использования

  • Исследование управляемой генерации видео для игр с учётом действий.
  • Создание прототипов геймплейных роликов по одному концепт-изображению и вводу движений.
  • Эксперименты с продолжением длинных видео на многопроцессорных серверах Linux с несколькими GPU.

Быстрый старт

  1. 1

    Клонируйте репозиторий

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

    Создайте окружение conda

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

    Установите PyTorch и зависимости pip

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

    Скачайте веса предварительно обученной модели (см. weights/README.md)

  5. 5

    Запустите веб-интерфейс Gradio

    bash scripts/launch_app_sp.sh

Что важно знать

  • Требуется NVIDIA GPU с поддержкой CUDA; необходимо не менее 24 ГБ видеопамяти, рекомендуется 80 ГБ.
  • Тестировалось только в Linux.
  • При малом объёме VRAM инференс выполняется очень медленно.
  • Время инференса линейно увеличивается с длиной последовательности действий.

Темы

Частые вопросы

Что такое Hunyuan-GameCraft-1.0?
Открытая модель для создания интерактивных игровых видео: она превращает референсное изображение и ввод с клавиатуры или мыши в управляемый геймплейный ролик. Hunyuan-GameCraft — модель генерации видео от Tencent Hunyuan, предназначенная для создания интерактивных игровых роликов. На вход подаются референсное изображение, текстовый промпт и последовательность действий с клавиатуры или мыши, например W, A, S, D. Модель создаёт видео, в котором камера движется согласно этим действиям. Ввод с клавиатуры и мыши преобразуется в общее пространство представления камеры, благодаря чему движения можно плавно интерполировать.
Hunyuan-GameCraft-1.0 можно использовать бесплатно? Какая у него лицензия?
Hunyuan-GameCraft-1.0 распространяется с открытым исходным кодом под лицензией Other. Перед использованием в коммерческих продуктах проверьте условия лицензии.
Hunyuan-GameCraft-1.0 всё ещё поддерживается?
Нет коммитов больше 6 месяцев. Последний коммит в Hunyuan-GameCraft-1.0 — 28 нояб. 2025 г..
Для чего можно использовать Hunyuan-GameCraft-1.0?
Исследование управляемой генерации видео для игр с учётом действий. Создание прототипов геймплейных роликов по одному концепт-изображению и вводу движений. Эксперименты с продолжением длинных видео на многопроцессорных серверах Linux с несколькими GPU.
Как установить Hunyuan-GameCraft-1.0?
Клонируйте репозиторий: git clone https://github.com/Tencent-Hunyuan/Hunyuan-GameCraft-1.0.git Создайте окружение conda: conda create -n HYGameCraft python==3.10 Установите PyTorch и зависимости pip: python -m pip install -r requirements.txt Скачайте веса предварительно обученной модели (см. weights/README.md) Запустите веб-интерфейс Gradio: bash scripts/launch_app_sp.sh
Где скачать Hunyuan-GameCraft-1.0?
Исходный код и инструкции по установке — на GitHub: https://github.com/Tencent-Hunyuan/Hunyuan-GameCraft-1.0

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Веб-интерфейс на базе Gradio для запуска Stable Diffusion и новых моделей генерации изображений и видео — продолжение форка Forge с поддержкой дополнительных моделей и оптимизациями.

1,8 тыс.253PythonAGPL-3.0Обновлён вчера

Движок с открытым исходным кодом для генерации изображений, видео и аудио с помощью Diffusion-моделей; поддерживает инференс и обучение при небольшом объёме VRAM.

13,3 тыс.1,3 тыс.PythonApache-2.0Обновлён 6 часов назад