Skip to content

GraphRun and review

Run nodes and see what will happen first

Running nodes in Nodespell executes the selected part of your graph and everything it needs upstream. Before anything starts, Nodespell prepares a run plan that says which nodes reuse their existing takes, which update for free, and which generate new results, so you only spend credits where you choose to.

  1. In Graph, select one or more nodes.
  2. Look at the run control that appears in the graph toolbar next to the selection count. Its label tells you what will happen (see the table below).
  3. Hover the run control to preview the plan on the canvas, then click it, or press Cmd+Shift+R on macOS or Ctrl+Shift+R on Windows and Linux.

The same control appears at the top of the menu when you right-click a node, and Run Selected Tasks is available in the command palette (Cmd/Ctrl+K).

Label on the run control What it does
Run Uses the takes you already have. Nothing is charged.
Generate or Generate with a number Makes new takes for the selected AI nodes with the current settings, even if nothing changed. Other paid nodes keep their takes.
Generate a number & run Some upstream nodes have no take yet. This generates them, then runs.
Up to date Everything selected is up to date, so clicking does nothing.

When the run control says Generate, its credit estimate sits beside the label. A run that uses no credits shows no price.

What runs, what is reused and what regenerates?

Section titled “What runs, what is reused and what regenerates?”

Nodespell reuses paid AI results until you explicitly ask for new ones. Selecting a downstream node and choosing Run does not regenerate an upstream image or video that already has a take; it uses the take that node currently uses. Non-AI nodes such as compositing or text nodes recalculate when their inputs change, and that work is free.

Each node in the plan gets one of these outcomes:

Outcome Meaning
Generate Makes a new take and spends credits.
Generate first take The node has no take yet, so the run creates one.
Reuse Uses the node’s existing take.
Keep selected take Uses the take you chose to keep for this node.
Update · free Recalculates a non-AI node at no cost.
Up to date / Not needed Nothing to do for this node.
Needs a take / Blocked The run cannot continue past this node yet.

Hover or keyboard-focus the run control, or any item in its menu, and the canvas shows the plan: each node in the plan is tinted and labelled with its outcome. Spending is shown in the accent color, free updates in green, reuse in a neutral tint, and blockers in amber with a dashed outline.

The tooltip repeats the plan as counts under What happens to each node and tells you how many planned nodes are off-screen or inside another Level, so nothing hidden runs without you knowing.

  1. Click the chevron on the run control (Run options) and choose Plan this run….
  2. Review Nodes in this run. For each AI node you can switch between Reuse and Generate. Reuse is unavailable for a node that has no take yet.
  3. Click the button at the bottom. Its label and price update to match your choices.

Your choices apply to this run only. When the main action would generate, Run options also offers Run with existing takes, with its own estimate: it runs with the takes you already have and never generates anything.

Use Run multiple times… to run one AI node several times with the same settings, for example to get a choice of images from one prompt.

  1. Select a single AI model node.
  2. Open Run options and choose Run multiple times….
  3. Pick the number of runs with the tiles 1 to 8 or the stepper. The dialog shows the Estimated total and the price per run.
  4. Click Run with the count, for example Run 4 times.

Each run is submitted separately and becomes its own take; some may wait for available capacity. A fixed seed stays unchanged across the runs. All runs reuse the same upstream takes, so if an upstream node has no take yet, prepare it with a single run first. After you submit, the tiles show each run as Queued, Running, Complete, Failed or Cancelled.

The estimate beside Generate, in Plan this run, and in Run multiple times is shown in credits. It can read as an exact number, a number with + when only a minimum is known, Free, or Price unknown. Live credit estimates are shown on paid plans; on other plans you can still run. If your balance cannot cover the run, the plan says Not enough credits for this run. and does not start.

While work is in progress, a running indicator with a count appears in the graph toolbar. Click it to open Task queue, which lists each run with its status, progress and current steps. Click Stop to cancel a run. A run that is waiting for this browser shows Resume.

If a plan is still being prepared, click Cancel waiting in the plan dialog. For a batch that could not be confirmed, Skip the rest… stops any runs that were not accepted; runs already accepted keep going. See Tasks panel for history and failures.

Why is the run control disabled or not running?

Section titled “Why is the run control disabled or not running?”
  • Up to date: there is nothing to run for the selection.
  • A run is already starting from this control. Wait for it to finish submitting.
  • The plan has a blocker, such as N nodes need a take first, a take that cannot load, or not enough credits. Clicking opens the plan so you can see why.
  • The plan could not be prepared. The control changes to Retry loading plan, and its tooltip gives the reason, for example a missing media reference in a prompt or an input that is still uploading.
  • The selection is a Folder. Folders cannot be run directly.
  • You are viewing the project rather than editing it. See Saving and recovery.

Before running, Nodespell may also show Check input connections if an input receives a different media type than it expects. Fix the connection, or choose Run anyway.

Takes are turned on per project, and new projects start with them. In a project without takes, the run control is a green Run button with a credit estimate, and its chevron (Task options) offers Run multiple times…, Restore results and Discard results. Results there are kept as result history rather than numbered takes, and Lock Result in the node’s Flags menu keeps a result for downstream runs. Cmd/Ctrl+Shift+R runs the selection in both kinds of project.

Does running a downstream node regenerate my images?

Section titled “Does running a downstream node regenerate my images?”

No. A downstream run reuses the take each upstream AI node currently uses. Choose Generate on that node, or switch it to Generate in Plan this run…, when you want a new result.

What is the keyboard shortcut to run selected nodes?

Section titled “What is the keyboard shortcut to run selected nodes?”

Press Cmd+Shift+R on macOS or Ctrl+Shift+R on Windows and Linux. It does the same thing as clicking the run control.

Run multiple times… lets you choose from 1 to 8 runs of one AI node. Each run becomes a separate take.

Live credit estimates before each run are a paid-plan feature. You can still run nodes on other plans.

Yes. Open the running indicator in the graph toolbar and click Stop on the run. The cancelled take stays in the node’s history marked Cancelled, with its charge status in its details.