GETTING STARTED

First Steps with Floww

Install Floww, create your first project, and build your first workflow.

System Requirements

Floww is a native desktop application built with Tauri. It runs on Linux with minimal system requirements.

Component	Requirement
Operating System	Linux (x86_64 or aarch64)
Runtime	WebKit2GTK 4.1+
RAM	4 GB minimum, 8 GB recommended
Disk Space	~150 MB for the application
Optional	Ollama (for local AI nodes)

On Arch-based distributions, install the WebKit2GTK dependency if it is not already present:

sudo pacman -S webkit2gtk-4.1

On Ubuntu/Debian-based distributions:

sudo apt install libwebkit2gtk-4.1-dev

Installation

Download Floww from floww.pro/download. Two distribution formats are available:

AppImage (Recommended)

The AppImage is a self-contained binary that works on any Linux distribution without installation.

# Make the AppImage executable
chmod +x Floww-*.AppImage

# Run it
./Floww-*.AppImage

Flatpak

If you prefer sandboxed applications, install via Flatpak:

flatpak install flathub pro.floww.Floww

First Launch

When you open Floww for the first time, you will see the Welcome Screen. It offers three paths:

• New Project — Create a blank project in a folder you choose.
• Open Existing — Open a folder that already contains a .floww file.
• Browse Examples — Load a bundled example project to explore.

The welcome screen also displays your recent projects for quick access. Floww remembers your last five opened projects.

Creating a Project

A Floww project lives inside a regular directory on your filesystem. When you create or open a project, Floww writes a .floww file at the root of that directory. This file stores your workflow graph, node configurations, and the Floww Prompt.

1. Click New Project on the welcome screen.
2. Choose an empty folder (or create a new one).
3. Floww initializes the folder and creates .floww.
4. The canvas opens, ready for your first node.

Your First Node

Nodes are the building blocks of every workflow. To add your first node:

1. Double-click on the canvas (or press A) to open the node picker.
2. Type a node name—try "Shell Command".
3. Select it from the list. The node appears on the canvas.
4. Click the node to open its configuration panel on the right.
5. In the command field, type: echo "Hello from Floww"
6. Click the Run button on the node (or press Enter).

The node executes the shell command and displays the output in its result area. You have just run your first node.

Your First Workflow

A workflow connects multiple nodes so that data flows from one to the next. Let's build a simple two-node pipeline:

1. Add a File Read node. Set its path to any text file on your system.
2. Add a Claude Prompt node. Set its prompt to: Summarize the following text: {{input}}
3. Connect them: Click the output port (right side) of the File Read node and drag a wire to the input port (left side) of the Claude Prompt node.
4. Click the Play button in the top toolbar to run the entire workflow.

Floww executes the File Read node first, passes its output to the Claude Prompt node, and displays the AI-generated summary. You have built your first workflow.

Next Steps

Now that you have Floww installed and a working workflow, explore the core concepts:

• Canvas — Learn to navigate, select, group, and organize nodes on the infinite canvas.
• Nodes — Discover all 22 built-in node types across five categories.
• Workflows — Understand DAGs, execution order, variables, and error handling.
• Floww Prompt — Write a living document that captures your project's intent.