Repolode
HKUDS

HKUDS/ViMax

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

Звёзды
12,707
Форки
1,927
Открытые issues
53
Последний коммит
20 дней назад

Что это?

ViMax — агентный фреймворк для создания видео, который автоматизирует весь процесс — от повествовательной задумки до готового ролика. Он охватывает написание сценария, создание раскадровки, разработку персонажей и референсов, планирование кадров, генерацию изображений и видео, а также финальную сборку. Поэтому начать можно с краткой идеи или большого текста, не создавая вручную каждый кадр.

В проекте предусмотрено несколько сценариев работы: Idea2Video развивает краткую задумку в персонажей, сценарии и раскадровки; Script2Video превращает готовый сценарий в видео из нескольких управляемых сцен; Novel2Video адаптирует объёмную прозу в визуальные истории с эпизодами; а AutoCameo добавляет человека или питомца с референсной фотографии в сгенерированные истории. Совместимые кадры и медиаматериалы можно генерировать параллельно.

ViMax можно запускать через TUI командной строки с возможностью возобновлять сессии или через локальный Web UI с именованными проектами, загрузкой файлов, предпросмотром артефактов и раскадровок, а также настройкой провайдеров. Для работы нужен Python 3.12; управление окружением выполняется через uv. Фреймворк поддерживает настраиваемых провайдеров чат-моделей, моделей изображений и видео.

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

  • 01Создаёт готовое видео по краткой идее, включая сценарий, раскадровку и кадры.
  • 02Преобразует готовые сценарии в видео из нескольких сцен и кадров.
  • 03Адаптирует объёмную прозу в визуальные истории с эпизодами.
  • 04Сохраняет внешность человека или питомца неизменной в разных сгенерированных сценах.
  • 05Предоставляет интерактивный TUI и локальный Web UI для планирования, доработки и управления рендерингом.
  • 06Параллельно генерирует совместимые кадры и медиаматериалы.

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

  • Создание прототипов короткометражек или трейлеров по письменной задумке.
  • Подготовка чернового видео из нескольких кадров по сценарию для просмотра и обсуждения.
  • Адаптация главы романа в эпизодическое видео в стиле анимации.
  • Создание персонализированных коротких историй с фотографией пользователя.

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

  1. 1

    Установите uv (см. документацию uv по ссылке в README).

  2. 2

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

    git clone https://github.com/HKUDS/ViMax.git
  3. 3

    Перейдите в каталог проекта и установите зависимости.

    cd ViMax && uv sync
  4. 4

    Создайте локальную конфигурацию агента, добавьте ключи API и запустите TUI.

    cp configs/agent.example.yaml configs/agent.local.yaml

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

  • Потребуются ключи API для провайдеров LLM, генерации изображений и видео; расходы могут быть значительными.
  • Для запуска сначала нужно настроить YAML-файл с информацией о моделях и провайдерах.
  • В README указана поддержка только Linux и Windows.

Темы

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

Что такое ViMax?
Агентный фреймворк для создания видео: превращает идею, сценарий или роман в видео из нескольких сцен, координируя работу агентов по созданию сценария, раскадровки, персонажей и видео. ViMax — агентный фреймворк для создания видео, который автоматизирует весь процесс — от повествовательной задумки до готового ролика. Он охватывает написание сценария, создание раскадровки, разработку персонажей и референсов, планирование кадров, генерацию изображений и видео, а также финальную сборку. Поэтому начать можно с краткой идеи или большого текста, не создавая вручную каждый кадр.
ViMax можно использовать бесплатно? Какая у него лицензия?
ViMax распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
ViMax всё ещё поддерживается?
Активно поддерживается. Последний коммит в ViMax — 30 сент. 2026 г..
Для чего можно использовать ViMax?
Создание прототипов короткометражек или трейлеров по письменной задумке. Подготовка чернового видео из нескольких кадров по сценарию для просмотра и обсуждения. Адаптация главы романа в эпизодическое видео в стиле анимации. Создание персонализированных коротких историй с фотографией пользователя.
Как установить ViMax?
Установите uv (см. документацию uv по ссылке в README). Клонируйте репозиторий.: git clone https://github.com/HKUDS/ViMax.git Перейдите в каталог проекта и установите зависимости.: cd ViMax && uv sync Создайте локальную конфигурацию агента, добавьте ключи API и запустите TUI.: cp configs/agent.example.yaml configs/agent.local.yaml
Где скачать ViMax?
Исходный код и инструкции по установке — на GitHub: https://github.com/HKUDS/ViMax

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

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