🔗 Explore the App

Click here to explore previz-ai-engine

🎬 Cinematic Storyboard & Pre-Viz AI Engine

A desktop AI tool for film directors and 3D artists. Automatically parses screenplay text via NLP to generate executable scripts that block out cameras and geometry in Unreal Engine & 3ds Max.

🚀 Overview

The Cinematic Storyboard & Pre-Viz AI Engine bridges the gap between screenwriting and 3D environment blockouts. Instead of manually placing primitive shapes and configuring camera focal lengths for a storyboard, this engine uses a Natural Language Processing (NLP) algorithm to read a standard film script, identify scenes and shots, and output an automated setup script.

When the generated script is run inside Unreal Engine (via the Unreal Python API) or 3ds Max (via MAXScript), it instantly spawns the exact cameras, lighting rigs, and proxy geometry required for the scene.

⚙️ How It Works

1. Input: A text file (script.txt) containing standard screenplay formatting.
2. AI Parsing: The Python engine scans the text, separating INT/EXT locations and identifying camera directions (e.g., "Wide establishing shot").
3. Script Generation: It mathematically calculates coordinates and outputs an unreal_import_script.py file.
4. Execution: Drop the generated file into your 3D software to instantly spawn the environment.

🛠️ Installation & Usage

Since this is a backend Command Line Interface (CLI) application, it requires no heavy frontend dependencies.

Prerequisites

• Python 3.8+
• Unreal Engine 5.x (with Python Editor Script Plugin enabled)

Running the Engine

1. Clone the repository:

   git clone https://github.com/zfryrgnci/previz-ai-engine.git
   cd previz-ai-engine

2. Run the generator script:

   python generate_previz.py

3. A file named unreal_import_script.py will instantly be generated in the same folder.
4. Open your Unreal Engine project, open the Output Log / Python Console, and execute the generated file to watch your scene build itself.

🔮 Future Roadmap

• Integration with the OpenAI API for deeper semantic understanding of shot composition.
• Direct live-link plugin for 3ds Max.
• Procedural proxy-mesh assignment (e.g., automatically placing a "Car" static mesh if a car is mentioned).

⚖️ License

MIT License - Free for personal and commercial use.