Installing pod on a Mac

One pasted line in Terminal puts a complete AI film studio on your Mac. This page walks you through it slowly, assuming you have never opened Terminal in your life.

What you're about to do

pod is a tiny AI film studio that lives on your own computer. Once installed, you type pod, talk to it in plain language ("make a 30-second teaser for my thriller, telugu, moody"), and it writes, casts, designs, shoots, quality-checks and edits a finished short film. Everything it makes saves to an episodes folder on your Mac. That's the only copy; pod's makers never store your footage or scripts.

Installing takes about two minutes of your attention. There is no app to drag into a folder and nothing to sign up for just to install. The one account you'll make (your generation key at kie.ai) comes later, in the key wizard, unless you're on a managed account. The whole thing happens in Terminal, which is just a window where you type instructions to your Mac instead of clicking them.

Step 1: Open Terminal

Terminal comes with every Mac. It looks intimidating and isn't: it's a blank window with a blinking cursor, waiting for you to type something and press Enter (Enter means "do it").

1. Press Cmd-Space together. A search bar (Spotlight) appears in the middle of your screen.
2. Type Terminal.
3. Press Enter. A window opens with some text and a cursor.

Step 2: Paste the install line

Copy this entire line, click into the Terminal window, paste it (Cmd-V), and press Enter:

❯ curl -fsSL https://lic.brainpuddle.com/install.sh | sh

What this does, in plain words: it downloads pod's installer from pod's own server and runs it. First the installer works out which kind of Mac you have. Apple Silicon (M-series) or Intel, it detects this automatically, so you don't need to know which one you own. Then it puts the right version of pod in place and adds it to your PATH so you can type pod from anywhere. It also checks the download against pod's signed release manifest before installing it: if a single byte doesn't match, it stops rather than install. You'll see it print progress as it works.

Step 3: Start pod for the first time

When the installer finishes, type:

❯ pod

Two things happen on this very first run, in this order:

• The key wizard, first. A friendly setup asks for up to three things: your pod license key (pod_sk_…, from whoever gave you pod), your generation key from kie.ai/api-key (this is what pays for the AI image and video generation, on your own account with your own balance; topping up around $5 is enough to start), and an optional ElevenLabs key for voice-over (press Enter to skip it). If you're on a managed studio account, generation is included, so you enter only the license key and skip the rest. The full walkthrough lives on the keys page.
• Then the toolchain download (~250 MB, one time only). With your keys in, pod fetches the tools it needs to cut and dress your films locally: a video engine and a graphics renderer for things like title cards. You'll see live progress while it downloads, and it ends by offering you a free demo clip. This never happens again: every launch after this one is instant.

Keys are saved to a private file in your home folder that only you can read. There is nothing else to configure, and nothing for you to install: pod brings its own video engine and renderer, so there's no ffmpeg, Node or Python to set up and no config file to write by hand. First launch also plays a 30-second tour of the studio.

If Terminal says "command not found"

This is the most common hiccup and it's harmless. Terminal learned about pod after the window was opened, so it doesn't know the name yet.

1. Close the Terminal window completely (Cmd-Q).
2. Open it again (Cmd-Space, type Terminal, Enter).
3. Type pod and press Enter.

If it still doesn't start after a fresh Terminal window, see Troubleshooting.

Prove it works: the health check

pod ships with its own studio technician. Any time you want to confirm the setup is healthy (right after installing is a great moment), run:

❯ pod doctor
  (checks the whole setup, fixes what it can,
   and renders two free local test clips)

pod doctor re-checks everything and renders two free test clips on your own machine, with no credits spent and no internet generation. If the clips play, your studio is ready. Run it again whenever anything ever looks off (wrong-looking titles, odd visuals); it self-heals the toolchain.

Want a taste before spending anything on a real production? Inside the studio, type demo. It renders a free 5-second local clip to prove the pipeline end to end.

What you'll see once you're in

Typing pod drops you "inside the studio": a bordered input box with a ❯ prompt. From here you just talk: paste a whole script, name a screenplay PDF sitting in your Downloads, or type a one-line idea. The front desk turns your plain language (any language) into the exact command and shows it to you before running anything. Tab completes command words and your episode names; Ctrl-C cancels a running job but never kicks you out, and progress is checkpointed. Type help any time, exit to leave.

Quick recap

On Linux?

The exact same one-line installer works on Linux (x64). Paste it into your terminal, then run pod. Everything else in these docs is identical.