Whatif

README excerpt

# whatif

Whatif is an AI-native local studio using a swarm to help independent filmmakers build worlds with git enabled version control, generative story board building, character development, and streamlined pipeline to video gen models.

As a filmmaker, all you have to do is ask "what if" and watch your intent be transformed into characters, story lines, and real scenes from your film.

![Whatif Storyboard Generator](public/whatif-ui.png)

## Usage flow

As a filmmaker, you move from raw script to explorable world to final export. The flow below guides you through each phase.

```mermaid
flowchart LR
    subgraph usage [Usage Flow]
        A[Ingestion] --> B[Interactive World]
        B --> C[What If Changes]
        C --> D[Export]
    end
```

### 1. [Ingestion](docs/ingestion.md)

Import your script and build the world. The pipeline parses the script, extracts characters/scenes/locations/props, infers narrative intelligence (events, storylines, knowledge, relationships), envisions production (camera, lighting, blocking, audio), indexes everything to SQLite, and supports human review before commit. Output: a live project with characters, scenes, events, storylines, and production state ready for exploration.

### 2. [Enter interactive world](docs/interactive-world.md)

Pick a scene at a specific point in the storyline. Enter the 3D viewer where characters are present. Adjust camera, scene layout, and character positions. You can impersonate individual characters to explo