HKUDS/ViMax

O que é?

Recursos principais

• 01Gera um vídeo completo a partir de uma ideia breve, com roteiro, storyboard e planos.
• 02Converte roteiros explícitos em vídeos com várias cenas e vários planos.
• 03Adapta obras de ficção longas para narrativas visuais episódicas.
• 04Mantém a aparência de uma pessoa ou de um animal de estimação consistente entre as cenas geradas.
• 05Oferece uma TUI interativa e uma Web UI local para controlar o planejamento, as revisões e a renderização.
• 06Gera planos compatíveis e recursos de mídia em paralelo.

Casos de uso

• Criar protótipos de curtas ou trailers a partir de um conceito escrito.
• Transformar um roteiro em um vídeo preliminar com vários planos para revisão.
• Adaptar um capítulo de romance para um vídeo episódico com estilo de animação.
• Criar histórias curtas personalizadas com a foto do próprio usuário.

Início rápido

1. 1

   Instale o uv (consulte a documentação do uv vinculada no README).

2. 2

   Clone o repositório.

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

   Acesse o diretório do projeto e instale as dependências.

   cd ViMax && uv sync
4. 4

   Crie uma configuração local do agente, adicione suas chaves de API e, em seguida, inicie a TUI.

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

Antes de usar

• !São necessárias chaves de API de provedores de LLM e de geração de imagens e vídeos, o que pode gerar custos significativos.
• !Antes de executar qualquer coisa, é preciso configurar um arquivo YAML com os detalhes dos modelos e provedores.
• !O README informa suporte apenas para Linux e Windows.

Tópicos

Perguntas frequentes

O que é ViMax?

Framework agentic de geração de vídeos que transforma uma ideia de história, um roteiro ou um romance em um vídeo com vários planos, coordenando agentes de roteiro, storyboard, personagens e geração de vídeo. ViMax é um framework agentic de criação de vídeos que automatiza o caminho de uma narrativa até um vídeo finalizado. Ele abrange escrita de roteiro, criação de storyboard, design de personagens e referências, planejamento de planos, geração de imagens e vídeos e montagem final, permitindo começar com um conceito breve ou um texto longo, sem produzir cada plano manualmente.

ViMax é gratuito? Qual é a licença?

ViMax é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

ViMax ainda é mantido?

Manutenção ativa. O último commit de ViMax foi em 30 de set. de 2026.

Para que posso usar ViMax?

Criar protótipos de curtas ou trailers a partir de um conceito escrito. Transformar um roteiro em um vídeo preliminar com vários planos para revisão. Adaptar um capítulo de romance para um vídeo episódico com estilo de animação. Criar histórias curtas personalizadas com a foto do próprio usuário.

Como instalar ViMax?

Instale o uv (consulte a documentação do uv vinculada no README). Clone o repositório.: git clone https://github.com/HKUDS/ViMax.git Acesse o diretório do projeto e instale as dependências.: cd ViMax && uv sync Crie uma configuração local do agente, adicione suas chaves de API e, em seguida, inicie a TUI.: cp configs/agent.example.yaml configs/agent.local.yaml

Onde consigo ViMax?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/HKUDS/ViMax