Skip to content

Concepts overview

IronFlow splits work into a Rust orchestration kernel (rust-engine) and Prefect-shaped Python authoring (prefect_compat). The kernel owns durable flow/task state and valid transitions; Python runs your @flow / @task code and calls into the control plane.

Use these pages to learn the IronFlow model end-to-end:

  • Flows — @flow, flow runs, and transition hooks.
  • Tasks — @task, submit, map, futures.
  • Runners — task runners and concurrent map.
  • States and transitions — RunState values and allowed edges (enforced in Rust).
  • Prefect → IronFlow — table mapping Prefect mental models to this project.
  • Architecture — how Python calls the engine and where persistence hooks live.

For supported features and limits, see Compatibility matrix. For Prefect’s own tutorials, see the upstream Prefect 3 concepts (IronFlow implements a subset; compatibility is not universal).