Skip to main content

​
Flow Runner

The Flow Runner is Hyperclip’s execution engine. It takes your flow (the node graph you built in the Flow Builder) and runs it step-by-step to produce a finished video.

​
Execution model

The Flow Runner uses a ModularFlowRunner that:
  1. Converts your node graph into a topologically sorted sequence of steps
  2. Merges parallel groups into single choosable steps
  3. Separates background and interactive steps — background steps auto-execute, interactive steps wait for your input
  4. Manages artifacts — Data produced by each step (images, videos, text) is passed to downstream steps

​
Step types

​
Background steps

These execute automatically without user input:
  • Script generation
  • Image generation
  • Text-to-video generation
  • Image-to-video generation
  • AI transform
  • Multi-shot generation
Background steps show a loading spinner with a status message. Credits are deducted automatically before each generation.

​
Interactive steps

These pause execution and wait for your input:
  • Media Upload
  • TikTok Scraper
  • Text Editor
  • Review / Approve
  • Auto Captions
  • Voiceover
  • Background Audio
  • Mixed Media Analysis
  • Multi-Angle Generation
  • Fixed Context Media
The flow runner displays a stepper showing only interactive steps. Background steps run between interactive steps without appearing in the stepper.
  • Use Next to advance to the next interactive step
  • Use Back to return to a previous step (skips background steps)
  • Background steps run automatically when you advance past them

​
Credit handling

Credits are checked and deducted before each AI generation step. If you don’t have enough credits, the step cancels and you’re notified.