Python Flow Engine

Lightweight Python flow orchestration — no external dependencies. Build pipelines with serial (>>), parallel (//), and conditional (|) node execution.

Core API

Node

from pipeline import Node

def my_fn(context, data):
    # context: shared dict for the pipeline run
    # data: input from previous node
    return modified_data

node = Node(my_fn, name="step1", timeout=10, retry=1)

Pipeline

pipe = Pipeline()
pipe.add_node(node)
pipe.run(start_node, input_data)

Connection Operators

For conditional connections, use connect():

pipe.connect(node_a, node_b, "conditional",
    condition=lambda ctx, data: ctx.get("is_valid", False))

Or use Node.condition parameter:

node_b = Node(fn, condition=lambda ctx, data: data > 0)

Visualization

print(pipe.visualize())  # outputs Mermaid.js flowchart

Error Handling

• retry: Node(fn, retry=2) retries up to 3 total attempts
• timeout: Node(fn, timeout=5) raises RuntimeError if execution exceeds 5s

Available Scripts

• scripts/pipeline.py — Core library (importable, no dependencies)
• scripts/pipeline_demo.py — End-to-end demo (6 scenarios)

Quick Start

from pipeline import Node, Pipeline

def double(ctx, x): return x * 2
def add_one(ctx, x): return x + 1

pipe = Pipeline()
n1 = Node(double, name="double")
n2 = Node(add_one, name="add_one")
pipe.add_node(n1)
pipe.add_node(n2)
n1 >> n2

result = pipe.run(n1, 5)  # 5*2+1 = 11
print(result)  # 11
print(pipe.visualize())

Run the full demo:

python scripts/pipeline_demo.py