Quick start

From download to your first shot.

Four steps. The only thing to prepare is one provider key — step two tells you where to get it.

  1. Install

    Download the build for your computer

    The installers are not code-signed yet, so the first launch gets a warning. Here’s how to get past it.

    v0.24.1

    macOS: if the first launch is blocked, open System Settings → Privacy & Security and click Open Anyway. Windows: on the SmartScreen prompt choose More info → Run anyway.

  2. Connect

    Connect a model with one key

    Open Settings → Models, pick APIMart or Kie.ai, and paste the key from their site — the common image, video and chat models are ready. You can also add your own relay or local ComfyUI, or click “Let AI connect it for me” and hand it to Claude Code or Codex.

    The “Let AI connect it for me” card in settings
  3. Ask

    Say what you want to make

    Create a project and tell the agent panel on the right, in plain words: what, how many shots, roughly how long. Start with the default Auto-edit level — it edits documents and the timeline without bothering you, and asks before any paid generation.

    The agent put four keyframes on the canvas
  4. Export

    Keep the good takes, arrange, export

    For a shot you don’t like, change the prompt or the model in the storyboard and generate again; lock a reference card to keep a character consistent. Arrange the timeline and export MP4.

    All four shots generated in the storyboard

I want to do X — which way?

Keep the same person in every shot

Lock a reference card for the character. Every storyboard shot that uses it carries the reference, so the model knows it is the same person.

Character and scene recipes →

Control who stands where and which way they face

Open the 3D director’s stage, pose the characters, place the camera and frame it with your phone; the frame returns to the canvas as the shot’s first frame.

3D director’s stage →

Make the camera move

Pick a move under Camera in the prompt library (dolly in, pull back, pan, follow, orbit…) and apply it to the shot or copy it into your prompt.

Camera prompts →

Not sure which model to use

Start with the model library: modes, reference limits, durations and where to connect each model, all on one page.

Models →

Add captions and music

Switch to Preview and use “+ Captions” and “+ Music” under the timeline, then export MP4.

Precise lip sync

Not supported yet. For shots that need it, make them in another tool and import the result.

If you get stuck

I connected a model but cannot generate

Check whether the model picker marks the model as unavailable and why: usually the key is wrong or that provider has not enabled the model for you. Switch to another provider or enable it in the provider’s console.

The face changes from shot to shot

Check that the shots are connected to the character’s reference card. Without it the model does not know who it is; connect it and regenerate those shots.

The agent stopped halfway

On long tasks it pauses to confirm, especially before spending money. Read what it is asking and reply “continue”.

FAQ

How much does it cost?

Nomi itself is free. Generation costs whatever your provider charges, settled directly between you and them. Free models (some on ModelScope, for example) and local ComfyUI cost nothing.

Do I need a GPU?

No. By default Nomi uses cloud APIs, so an ordinary laptop is enough. Local ComfyUI is optional — add it if you have a GPU and want to save money.

Is my footage uploaded?

Projects live on your own computer. Only when you call an external model does the content that generation needs go to the provider you configured.

Can the agent hand me a finished film?

It can go from one sentence to characters, keyframes and video, and lay them on the timeline. Export is still one click by you. On long tasks it may pause to check in — reply “continue”.

Keep going

Choose the version for this computer

Nomi downloads directly when the platform is known. If the Mac chip cannot be detected reliably, choose the matching installer.

First launch on macOS

The current macOS build is not Apple Developer ID signed or notarized. Only use download links on this site or in the official Nomi GitHub repository.

  1. Download the matching DMG, open it, and drag Nomi onto Applications.
  2. Open Nomi from Applications. The first launch is blocked: close the prompt, and don’t choose Move to Trash.
  3. Open System Settings → Privacy & Security, scroll down to Security, click Open Anyway next to the Nomi message, and confirm (on macOS 12: System Preferences → Security & Privacy → General).

Only if macOS says Nomi is “damaged”: confirm the installer came from an official link above, then open Terminal and run:

xattr -dr com.apple.quarantine "/Applications/Nomi.app"

You do not need to disable Gatekeeper globally, and should not do so.