Back topod. pod docs

What is pod?

pod is a tiny AI film studio that lives on your own computer. You describe the film you want in plain language, and a crew of specialized AIs writes it, casts it, shoots it and edits it into a finished short film.

Made with pod: a 2:44 showreel across chariot epics, jungle drones, palace monsoon drama, feature animation, rain-noir, macro and underwater, plus real client work. One brief in, every shot planned, generated, quality-checked and cut by the crew.

You don't need to know anything about software, prompts, or "AI models" to use pod. You need one thing: a picture in your head of the film you want. A 30-second teaser for your thriller. Episode 2 of the telugu vertical series a client handed you as a PDF. Two robots falling in love at a bus stop. You tell pod, in your own words, in any language, and pod makes the film.

New: Pod Studio, a browser view. When you run pod, a web page opens in your browser automatically. It opens on your films, a grid of everything you've made, and clicking one lays its whole production out as visual cards on a studio wall: brief, script, characters, shots, clips, the final cut, each playing right there. A chat box at the bottom is the same front desk as the terminal: type in plain English, pod proposes the exact command with Run · Edit · Never mind buttons, and nothing runs until you click Run. If typing in a Terminal isn't your thing, you can steer the whole film from the page. It's local and private, living on your own machine (127.0.0.1) with nothing served to the network. Prefer the terminal only? Set POD_NO_UI=1. Full tour: talking to pod.

The crew

Think of pod as a small studio behind a front desk. When you hand over an idea, it doesn't go to one AI trying to do everything. It moves through a crew, each member doing the one job it's specialized for:

You sit in the director's chair. Everything the crew makes comes back to you for review, and your notes, in plain words, are what they act on.

What you can make

The default is a ~2-minute episode in widescreen, but pod handles the whole spread of short-form film work:

You can also bring your own material: reference images for a character, finished clips, audio for voice-over or music. pod folds all of it into the production. See using your own media.

You direct every step

Today pod runs in one mode: full control. Pod stops at every gate (the script, the cast and look, the shot plan, the keyframes, each scene's clips, the final cut), shows its work, and waits for you. You are the quality control, and no AI loop judges your film or spends a credit behind your back.

Two hands-off modes are temporarily benched while we make them worthy of real productions: assisted steer, where AI critics pre-check every image and clip, and autopilot, where pod runs the shoot itself and stops only at the cost gate. Typing auto at a gate politely declines for now. They're returning, and the modes page covers how they'll work. Speak real cinematography if you want ("shot-03: over-the-shoulder, 85mm, golden hour") and the crew translates it precisely. The full vocabulary is in camera language.

The promise

Note: pod runs inside your computer's Terminal, a plain window where you type and press Enter. That's the whole skill requirement. Install is one pasted line on a Mac, or a single downloaded file on Windows, and there are no dependencies to install yourself. The quickstart walks you through every keystroke.

What it looks like

❯ make a 30-second teaser for my thriller, telugu, moody
Here's what I'll run — Enter to go, e to edit, n to never mind:
  produce "my thriller teaser" --duration 30 --language telugu --teaser
  (pod turns your plain words into the exact command and shows it first)

From there the crew gets to work, and pod brings each stage back to you for review. Press Enter to approve, or just say what to change: "make the ending happier", "give Meena a red saree", "cut the first 3 seconds".

Where your films live: in an episodes folder on your computer, created wherever you started pod from. On a Mac that's normally your home folder (Finder → Go → Home). On Windows, if you double-clicked pod.exe, it sits right next to it, or inside the pod folder if you installed the folder version. It's the only copy, so back it up like any hard drive of footage.

Where to next

And if you're not one director but a studio, with several people, several client accounts, and customers who need to see cuts and sign off on them, that part is built: seats, projects, a publish gate and a record of every approval. Start at studio seats & roles.