Repolode
NoizAI

NoizAI/HelixWorld

Um modelo de mundo interativo em tempo real que gera uma cena navegável a partir de uma imagem e um prompt, atualizando juntos a imagem e o áudio estéreo alinhado à câmera.

Estrelas
626
Forks
32
Issues abertas
2
Último commit
anteontem

O que é?

O HelixWorld recebe a imagem do primeiro quadro e um prompt de texto e, em seguida, gera uma cena pela qual o usuário pode se deslocar. Andar para a frente ou virar atualiza tanto a imagem quanto o som, e o campo de áudio espacial gira junto com a câmera. O projeto trata o áudio como algo gerado em conjunto com os elementos visuais, em vez de adicioná-lo depois como trilha sonora.

O modelo injeta poses contínuas de câmera em 6 DoF no ramo de vídeo usando Projective Relative Positional Encoding e usa atenção multimodal para conectar a geometria visual aos recursos acústicos. O repositório oferece o código de inferência do Preview v1, que roda no Linux com Python 3.11, CUDA 12.x e uma GPU NVIDIA; a recomendação é ter 80 GB de VRAM. As entradas incluem sequências de ações como W/A/S/D e teclas de câmera, e a saída é um arquivo MP4.

O projeto também disponibiliza o HelixBench, um benchmark para verificar se os campos sonoros gerados acompanham o movimento do ponto de vista, além de uma demonstração no navegador e um relatório técnico no arXiv.

Recursos principais

  • 01Gera uma cena navegável a partir de uma única imagem e de um prompt de texto.
  • 02Sincroniza a imagem e o áudio estéreo alinhado à câmera durante a interação.
  • 03Aceita sequências de ações pelo teclado, como W, A, S, D e movimentos da câmera.
  • 04Executa inferência em uma única GPU com precisão BF16 e exporta a saída em MP4.
  • 05Inclui o benchmark HelixBench para avaliar a consistência acústica espacial.

Casos de uso

  • Pesquisar modelos de mundo audiovisuais e geração de vídeo condicionada pela câmera.
  • Criar protótipos de cenas interativas em que o som acompanha o movimento do usuário.
  • Avaliar com o HelixBench se o áudio gerado acompanha as mudanças do ponto de vista.

Início rápido

  1. 1

    Clone o repositório

    git clone https://github.com/NoizAI/HelixWorld.git
  2. 2

    Crie o ambiente conda do Python 3.11

    conda create -n helixworld-preview python=3.11 -y
  3. 3

    Instale as dependências e baixe os pesos do modelo

    python -m pip install -r requirements.txt && python download_models.py
  4. 4

    Execute a inferência em uma GPU usando uma imagem do primeiro quadro e um arquivo de prompt

    CUDA_VISIBLE_DEVICES=0 ./run.sh --image /path/to/first_frame.png --prompt-file examples/prompt.json --actions "W:5,right:5,stop:5" --perspective first_person --num-frames 121 --output-dir outputs/demo

Antes de usar

  • Requer Linux, Python 3.11, CUDA 12.x e uma GPU NVIDIA.
  • Uma execução com uma única GPU usa cerca de 70 GB de VRAM; recomenda-se 80 GB.
  • Esta é uma versão de prévia, portanto o comportamento pode mudar.
  • Os pesos do modelo têm uma licença separada da licença Apache 2.0 do código.

Tópicos

Perguntas frequentes

O que é HelixWorld?
Um modelo de mundo interativo em tempo real que gera uma cena navegável a partir de uma imagem e um prompt, atualizando juntos a imagem e o áudio estéreo alinhado à câmera. O HelixWorld recebe a imagem do primeiro quadro e um prompt de texto e, em seguida, gera uma cena pela qual o usuário pode se deslocar. Andar para a frente ou virar atualiza tanto a imagem quanto o som, e o campo de áudio espacial gira junto com a câmera. O projeto trata o áudio como algo gerado em conjunto com os elementos visuais, em vez de adicioná-lo depois como trilha sonora.
HelixWorld é gratuito? Qual é a licença?
HelixWorld é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
HelixWorld ainda é mantido?
Manutenção ativa. O último commit de HelixWorld foi em 19 de out. de 2026.
Para que posso usar HelixWorld?
Pesquisar modelos de mundo audiovisuais e geração de vídeo condicionada pela câmera. Criar protótipos de cenas interativas em que o som acompanha o movimento do usuário. Avaliar com o HelixBench se o áudio gerado acompanha as mudanças do ponto de vista.
Como instalar HelixWorld?
Clone o repositório: git clone https://github.com/NoizAI/HelixWorld.git Crie o ambiente conda do Python 3.11: conda create -n helixworld-preview python=3.11 -y Instale as dependências e baixe os pesos do modelo: python -m pip install -r requirements.txt && python download_models.py Execute a inferência em uma GPU usando uma imagem do primeiro quadro e um arquivo de prompt: CUDA_VISIBLE_DEVICES=0 ./run.sh --image /path/to/first_frame.png --prompt-file examples/prompt.json --actions "W:5,right:5,stop:5" --perspective first_person --num-frames 121 --output-dir outputs/demo
Onde consigo HelixWorld?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/NoizAI/HelixWorld

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

Projetos relacionados