Learn By Example

Learn By Example

The fastest way to understand GraphK is to follow a progression of runnable scenarios.

This path is for readers who want to see complete workflows first and study the extension points later.

Suggested Progression

1. First Request And Response

Start with the smallest useful public flow:

• one program
• one registered pipeline
• one emitter
• one session
• one response
• optional implicit default when only one pipeline is registered

Read:

• Example 1: First Request And Response

Runnable source:

• examples/example_1.py

2. Build A Sequential Architecture

Next, move from one node to a real architecture:

• multiple nodes
• ordered execution
• one coherent pipeline
• one program registration point

Read:

• Example 2: Build A Sequential Pipeline

Runnable source:

• examples/example_4.py

3. Add Context And Policy

Once the basic flow makes sense, learn how GraphK controls execution through scoped values and validation rules across Program, Runner, Pipeline, and Node.

Read:

• Example 3: Add Context And Policy

Runnable sources:

• examples/example_7.py
• examples/example_8.py

4. Route One Request To One Branch

Now move from simple sequence to conditional routing.

Read:

• Example 4: Route With BranchPipe

Runnable source:

• examples/example_5.py

5. Fan Out To Multiple Matching Branches

Finally, learn how GraphK executes multiple matching branches instead of selecting only one.

Read:

• Example 5: Fan Out With MultiPipe

Runnable source:

• examples/example_6.py

Recommended Supporting Tests

When you want more detail than the examples provide, these test directories are the best next references:

• tests/emitter/
• tests/sequence/
• tests/context/
• tests/policy/
• tests/branch/
• tests/multi/