Flow

Overview

A Flow tab is a canvas. Each block on it does one job: it writes text, or makes an image, a video, a 3D model, sound or a world. A connection carries one block's result into the next block, so a chain of blocks becomes a workflow you build once and run again with new inputs.

The Main tab of every project is a Flow tab. A Flow tab has two views, picked in the view menu next to your balance in the top bar: Canvas, which this page describes, and Interface, which shows the same workflow as a simple form with a Run button.

Shortcuts on this page are written for Mac. On Windows, use Ctrl where it says ⌘.

Add blocks

• Click Add block, the + first in the canvas toolbar, or right-click the canvas. Both open the same menu, with the tabs All, Media, Text, Utilities, Apps and Actions, and a search field.
• Click the handle on a block's output side to add the next block, already connected.
• Drop files from your computer on the canvas to add them as blocks.
• Copy blocks and paste them with ⌘V, also from another project. Their media is copied with them.

Every block type has its own page under Blocks.

Connect and run

1. Drag from one block's output handle to another block's input. Only connections the receiving block can use are accepted.
2. Write a prompt in the block and pick a model in its settings. The model picker shows about what one run costs.
3. Press Run on the block.

Every run is kept as a version of the block, and connected blocks read the version on screen. See Context for what travels along a connection.

To run several blocks, select them and choose Run all in the selection toolbar. It asks you to confirm how many blocks will run. How many generations can run at the same time depends on your plan: when more are started than your plan runs at once, the extra blocks are skipped and a dialog says so.

Build with the agent

Raelume Agent works in a Flow tab too. Describe the result you want and it adds the blocks, connects them, writes the prompts and starts the runs on the canvas while you watch.

Canvas tools

The canvas toolbar holds:

• Move around (H) to pan the canvas.
• Notes and drawing: a note (N), a post-it (P) and Sketch (S) with a pen, a marker and a highlighter.
• Comment (C). See Comments.
• Undo (⌘Z) and redo (⌘⇧Z).
• The zoom menu: Zoom in (⌘+), Zoom out (⌘−), Zoom to fit (⇧1), Zoom to 100% (⌘0), Snap to grid and Smart guides.

Arrange a selection

Select several blocks to get the selection toolbar: Run all, Align, Distribute, Group, stacking the blocks, Interface role, Move to page and Make app. ⌘D duplicates the selection.

Make app packages the selected workflow as a reusable App.

Organize workflows with tabs

Give each separate workflow its own Flow tab. Branches that work together can stay on one tab, and loose blocks are fine. This keeps the canvas tidy and gives each tab a clear set of inputs and results in the Interface view, which needs one connected workflow per tab.

1. Click New tab (the + at the end of the tab bar) and choose Flow, or press ⌘⌥N (Ctrl Alt N on Windows) to add a Flow tab at once. Type its name.
2. Return to the original tab and select every block of the workflow you want to move.
3. Choose Move to page in the selection toolbar, then Move beside the destination. Connections between the selected blocks move with them; connections to blocks left behind do not cross tabs.
4. Switch tabs by clicking one, or with ⌘← and ⌘→ when you are not typing in a field.

Right-click a tab to rename, duplicate or delete it, and drag tabs to reorder them. The Main tab stays first and cannot be duplicated or deleted.

Watch the short paging guides.

The sidebar

The sidebar of a Flow tab has the sections Agent, Assets, Workflows, Apps and Comments.

Working together

Everyone in the project sees blocks, runs and cursors live. See Collaboration.