◆ Pi FlowDocs

Getting started

Install @piflow/core and the piflow CLI, then create and run your first workflow.

This is the full path from a clean machine to your first live run. For the shortest version, see the Quickstart.

Prerequisites

  • Node.js >= 20
  • A provider/gateway the fleet can call (set per run with --provider)

Install

See Installation for the supported install paths.

Create a workflow

Use the piflow-init skill to scaffold a workflow template. The source of truth is a structured template at .piflow/<workflow>/template/, which @piflow/core loads into a WorkflowSpec and runs one pi per node.

See Author a workflow.

Run it

piflowctl run .piflow/<workflow>/template --provider <gateway> --thinking low --sandbox local

Then follow it live — see Run on Pi and Monitor a run.

Next steps