topviewai / topview-3d-builder

Topview 3D Builder 
 Let AI build your 3D scenes 
 From an idea, to a 3D scene built by your agent, to a real animated video. Free, runs locally, no sign-up.
 Quick Start |
 Examples |
 Tutorial |
 3D Builder |
 Topview.ai |
 Issues 
https://github.com/user-attachments/assets/ae8923ce-e03e-473c-8e75-941bcb945f9c
 Build the scene, place the cameras, plan the camera move in Studio, then get the shot. 
## Quick Start
**Recommended model: Qwen 3.8 Flash.** It costs about 1/150 of GPT 6 Astra and reaches a similar result. We recommend using it.
Works with **ChatGPT / Codex**, **Qoder**, **Claude Code**, **Cursor** and any agent with skills support. You need Python 3.11+, Node.js 20.6+, and either uv or pipx.
**1. Install the plugin**
**ChatGPT / Codex**: open the plugin page in the app and install it from there.
Install Topview 3D Builder in ChatGPT / Codex
**Other agents (Qoder, Claude Code, Cursor, or any agent with skills support)**: send this to your agent.
 [code] 
 What your agent will run 
**Claude Code** (restart Claude Code afterwards)
 [code] 
**Cursor** (restart Cursor afterwards)
 [code] 
**Any agent with skills support, including Qoder**
 [code] 
Then pick `topview-3d-cli`. The first render downloads a browser component once; after that it is cached. For the CLI and project format, see the CLI reference.
**2. Start a new session and describe the scene you want**
> Build a scene: a character sits next to a box. Render a front view.
**3. Review the scene and keep refining**
Keep talking to your agent, or open Studio and adjust by hand. When you're happy, turn the 3D scene into a real animated video.
## What is Topview 3D Builder?
Topview 3D Builder is a **3D director's stage for AI video**. You describe the scene, and your agent builds it in 3D: who stands where, who faces what, what they hold, and where the camera sits. That 3D scene then guides the video model, so the staging comes from you instead of from luck.
It covers the whole path from **an idea, to a 3D scene, to a real animated video**. The 3D scene fixes blocking, scale and camera angles. Texture, lighting and performance come from the video model.
 [code] 
Everything before the video runs on your machine, free, with no account and no upload.
## What problem does it solve?
If you make AI videos, you've probably hit this: text prompts can't describe space precisely, so you can't control where people stand or where the camera goes. Directing AI video ends up feeling like gambling. 3D Builder gives you control back.
| The problem | How 3D Builder solves it |
| --- | --- |
| 😵 **Blocking is a guess.** "Two people facing each other across a table" comes back side by side, clipping, or without the table. | 🎬 **Direct, don't gamble.** You place characters, poses, props and cameras, so blocking and facing are decided, not guessed. |
| 🎰 **Camera angles are a lottery.** You write a paragraph and get one random angle. | 🎥 **Design the camera move in advance.** Plan push-ins, pull-backs, ri