Repolode
NoizAI

NoizAI/HelixWorld

Un modelo del mundo interactivo en tiempo real que genera una escena navegable a partir de una imagen y un prompt, con la imagen y el sonido estéreo alineado con la cámara que se actualizan a la vez.

Estrellas
626
Forks
32
Issues abiertos
2
Último commit
ayer

¿Qué es?

HelixWorld recibe la imagen del primer fotograma y un prompt de texto, y genera una escena que el usuario puede recorrer. Al avanzar o girar, se actualizan tanto la imagen como el sonido, y el campo de audio espacial gira con la cámara. El proyecto genera el audio conjuntamente con las imágenes, en lugar de añadirlo después como banda sonora.

El modelo incorpora poses de cámara continuas de 6 DoF en la rama de video mediante Projective Relative Positional Encoding y usa atención multimodal para vincular la geometría visual con las características acústicas. El repositorio ofrece código de inferencia de Preview v1 que funciona en Linux con Python 3.11, CUDA 12.x y una GPU NVIDIA; se recomiendan 80 GB de VRAM. Entre las entradas se incluyen secuencias de acciones como W/A/S/D y teclas de cámara, y la salida es un archivo MP4.

El proyecto también publica HelixBench, un benchmark para comprobar si los campos de sonido generados siguen el movimiento del punto de vista, además de una demo para navegador y un informe técnico en arXiv.

Funciones clave

  • 01Genera una escena navegable a partir de una sola imagen y un prompt de texto.
  • 02Sincroniza la imagen y el sonido estéreo alineado con la cámara durante la interacción.
  • 03Acepta secuencias de acciones de teclado como W, A, S, D y giros de cámara.
  • 04Ejecuta inferencias en una sola GPU con precisión BF16 y exporta la salida en formato MP4.
  • 05Incluye el benchmark HelixBench para evaluar la coherencia acústica espacial.

Casos de uso

  • Investigar modelos del mundo audiovisuales y la generación de video condicionada por la cámara.
  • Crear prototipos de escenas interactivas en las que el sonido siga el movimiento del usuario.
  • Evaluar con HelixBench si el audio generado sigue los cambios del punto de vista.

Inicio rápido

  1. 1

    Clona el repositorio

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

    Crea el entorno conda de Python 3.11

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

    Instala las dependencias y descarga los pesos del modelo

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

    Ejecuta la inferencia en una GPU usando una imagen del primer fotograma y un archivo de prompts

    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 usarlo

  • Requiere Linux, Python 3.11, CUDA 12.x y una GPU NVIDIA.
  • Una ejecución con una sola GPU utiliza unos 70 GB de VRAM; se recomiendan 80 GB.
  • Esta es una versión preliminar, por lo que el comportamiento puede cambiar.
  • Los pesos del modelo tienen una licencia distinta de la licencia Apache 2.0 del código.

Temas

Preguntas frecuentes

¿Qué es HelixWorld?
Un modelo del mundo interactivo en tiempo real que genera una escena navegable a partir de una imagen y un prompt, con la imagen y el sonido estéreo alineado con la cámara que se actualizan a la vez. HelixWorld recibe la imagen del primer fotograma y un prompt de texto, y genera una escena que el usuario puede recorrer. Al avanzar o girar, se actualizan tanto la imagen como el sonido, y el campo de audio espacial gira con la cámara. El proyecto genera el audio conjuntamente con las imágenes, en lugar de añadirlo después como banda sonora.
¿HelixWorld es gratuito? ¿Qué licencia tiene?
HelixWorld es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿HelixWorld sigue mantenido?
Mantenimiento activo. El último commit de HelixWorld fue el 19 oct 2026.
¿Para qué puedo usar HelixWorld?
Investigar modelos del mundo audiovisuales y la generación de video condicionada por la cámara. Crear prototipos de escenas interactivas en las que el sonido siga el movimiento del usuario. Evaluar con HelixBench si el audio generado sigue los cambios del punto de vista.
¿Cómo se instala HelixWorld?
Clona el repositorio: git clone https://github.com/NoizAI/HelixWorld.git Crea el entorno conda de Python 3.11: conda create -n helixworld-preview python=3.11 -y Instala las dependencias y descarga los pesos del modelo: python -m pip install -r requirements.txt && python download_models.py Ejecuta la inferencia en una GPU usando una imagen del primer fotograma y un archivo de prompts: 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
¿Dónde consigo HelixWorld?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/NoizAI/HelixWorld

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

Proyectos relacionados