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
3D-BUILDER-hero-9MB.mp4
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.
Install the Topview 3D Builder plugin from https://github.com/topviewai/topview-3d-builder for the agent I'm using (Qoder, Claude Code, Cursor or another agent with skills support). Follow the install steps in the README, then tell me when to restart.
What your agent will run
Claude Code (restart Claude Code afterwards)
claude plugin marketplace add https://github.com/topviewai/topview-3d-builder.git claude plugin install topview-3d-builder@topview-3d-builder
Cursor (restart Cursor afterwards)
git clone https://github.com/topviewai/topview-3d-builder.git ~/.cursor/plugins/local/topview-3d-builderAny agent with skills support, including Qoder
npx skills add https://github.com/topviewai/topview-3d-builder.git
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.
An idea → Agent builds the 3D scene → Auto-check and refine → Multi-camera render → Real animated video
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, rises, orbits and cuts on a timeline. |
| 🔁 One tweak, full redo. Move a character half a step and everything changes on regenerate. | ✏️ Edit one thing, keep the rest. The scene is a saved project. Move a character, change a pose or add a camera without starting over. |
| 💸 Retries burn credits. A usable shot can take a dozen attempts. | ✅ Checked before you generate. Floating or clipping characters, spacing and framing are measured automatically, so problems are caught early. |
| 🧩 Shots don't match. Character positions and space contradict each other from shot to shot. | 🎬 One scene, many cameras. Render several cameras from the same scene and characters and space stay consistent in every shot. |
| 📐 Not everyone can storyboard. No art skills means no way to show the staging in your head. | 💬 Just describe it. No 3D software to learn. Ask in plain language and your agent builds the scene. |
How it works
- Describe the shot. Tell your agent the scene you want, for example: "Two people sit across a table, a woman is talking. Give me a front, an over-the-shoulder and a top-down shot."
- The agent builds the 3D scene. It uses built-in characters, poses and props, and places the cameras.
- Check and refine. The scene is measured automatically. Keep talking to your agent, or open Studio and drag things around.
- Render and generate. Render the cameras, plan the camera moves, then turn the 3D scene into a real animated video.
Example
Each row shows the prompt, the 3D scene built from it, and the video generated from that scene: the way you stage it in 3D is the way it gets shot.
| Input | 3D scene generated by 3D Builder |
Generated video rendered by Topview.ai |
|---|---|---|
Reference image: Prompt: Build the 3D scene from the reference image. 0–3s: Pull back from the leaning man to show both men and the car. 3–5s: Over-the-shoulder push-in to the engine. 5–7s: Fixed first-person shot of the engine. |
12.1.mp4 |
12.2.mp4 |
Reference image: Prompt: Build the 3D scene from the reference image. 0–2.5s: Wide shot, slow push-in. 2.5–5s: Medium shot, tracking sideways. 5–7s: Close-up of him reading. |
1.2.mp4 |
1.1.mp4 |
| Prompt: A person stands beside a sports car in a showroom. In one continuous ten-second shot, the camera moves from a low angle by the front wheel to a frontal view of the person, then rises and moves around to reveal the car from above. | sports-car-one-take-scene.mp4 |
sports-car-one-take-video.mp4 |
| Prompt: A runner crosses a rooftop, leaps across a gap with a forward flip, lands on the next roof and keeps running. The camera follows from behind, keeping the jump and landing in frame. | parkour-rooftop-scene.mp4 |
parkour-rooftop-video.mp4 |
| Prompt: A player jumps and shoots at a hoop. The camera starts low beside them, then rises and pushes in toward the basket, finishing above the rim and looking down over eight seconds. | basketball-scene.mp4 |
basketball-video.mp4 |
More examples
| Input | 3D scene generated by 3D Builder |
Generated video rendered by Topview.ai |
|---|---|---|
| Prompt: A rider flies a dragon over a castle. The camera starts just behind and above them, looking forward over the wings at the towers. Over eight seconds it follows the flight as the dragon clears the castle and heads out over the hills. | dragon-scene.mp4 |
dragon-video.mp4 |
| Prompt: One person pours from a pitcher into a cup on a café counter. The camera starts wide across the counter, then pushes in and rises to a top-down close-up of the pour over eight seconds. | coffee-scene.mp4 |
coffee-video.mp4 |
| Prompt: A person rides a bicycle along a city street. The camera starts level and tracks alongside, then rises and pulls back to a high angle looking down the street over eight seconds. | bicycle-scene.mp4 |
bicycle-video.mp4 |
| Prompt: A rider on horseback rides through city traffic toward a red light. Over ten seconds the camera starts high behind the rider among the cars, then cuts to the horse's point of view, ears in the foreground, as it reaches the crosswalk. | horse-redlight-scene.mp4 |
horse-redlight-video.mp4 |
More prompts to try
Build a small café. Two people sit across a table from each other. Put the camera outside the window and slowly push in over four seconds. Render the first, middle and last frame.
A woman stands in a white studio holding a pose from the "walking" set. Three cameras: front, three-quarter, and a low angle. Render all three.
Put a car in the middle of an empty street. Orbit the camera 90 degrees around it over five seconds.
Take my current scene, add a second camera behind the main character, and cut to it halfway through.
Why Topview 3D Builder?
- Direct, don't gamble. Composition, eyelines and camera paths are decided before the video model runs.
- Edit, don't regenerate. The scene is a file, not a prompt. Move one prop and render again.
- Checked before you render. Framing, grounding, spacing and collisions are measured automatically, so mistakes surface early.
- A full 3D editor, not just an agent. Many code-driven 3D scene tools can only be changed through an agent. Topview 3D Builder ships a complete 3D software interface, Studio, and everything your agent can do has a matching panel you can use by hand.
- Agent-native. Works in ChatGPT / Codex, Cursor and Claude Code. You talk, your agent builds.
- Local by default. Building and rendering need no account and upload nothing.
- Open source. Code under Apache 2.0, built-in assets under CC BY 4.0.
Built-in assets
Ready to use out of the box.
| Asset | Count | Notes |
|---|---|---|
| 👤 Characters | 4 | Child, youth, woman, man |
| 🧍 Poses | 121 | Sitting, standing, walking, fighting, crawling, reaching and more |
| 📦 Props | Primitives | Boxes, cylinders and more, for quickly building tables, walls and objects |
| 🎥 Cameras | As many as you need | Story cameras plus a bird's-eye overview to see the whole staging at a glance |
Built-in assets are made by Topview and licensed under CC BY 4.0.
Who it's for
- AI film and TV creators. Keep character positions consistent across shots and get more usable footage per generation.
- Ad, brand and e-commerce content teams. Agree on staging and camera work before you spend generation credits, and keep people and products in a stable relationship across shots.
Directors, storyboard artists and anyone previsualizing a scene can use it too.
FAQ
Do I need any 3D modeling skills? No. Describe what you want in plain language. Your agent builds, checks and renders the scene.
Is it free? Do I need an account? Building, editing and rendering are free and need no account.
Is my content uploaded?
No. Every project stays in a .topview-3d/ folder on your machine.
Can it generate video? Yes. It covers the whole path from an idea, to a 3D scene, to a real animated video: you lock the staging first, then generate the video from that 3D scene.
Recommended models
| Model | Rating | Why |
|---|---|---|
| Qwen 3.8 Flash | ⭐️⭐️⭐️⭐️⭐️ | Good results at a very low price. The same task costs about 1/150 of Astra, so it has the best overall value. |
| Opus 5.5 | ⭐️⭐️⭐️ | Strong aesthetics, but expensive. |
| Astra | ⭐️⭐️⭐️ | Strong 3D results and fast generation, but the most expensive. |
Tutorial
Build scenes, stage action and move the camera
Learn more and join in
| 🌐 Topview.ai | www.topview.ai |
| 🎬 3D Builder home | www.topview.ai/3d-builder |
| 🛠 CLI reference | CLI and project format |
| 🐞 Feedback and bugs | GitHub Issues |
If Topview 3D Builder helps your work, give the repo a ⭐ and share what you make. We'd love to see it.
License
- Code, schemas and docs: Apache License 2.0
- Built-in assets (characters, poses and more): CC BY 4.0. Credit them as "Scene3D built-in assets © Topview, CC BY 4.0".
- Editor UI fonts (Instrument Sans, Darker Grotesque): SIL Open Font License 1.1.
Acknowledgements
Thanks to the Qwen team for their strong support of this project.