edgygraph 0.0.89

Graph-based Pipeline Builder

Typed Graph-like Pipeline Builder

A pydantically typed, lightweight graph framework for Python that combines features from Langgraph with static type safety.

A community collection of nodes will be available here.

Overview

• Pydantic Typing:
  Built on Pydantic and Generics for 100% strict static type safety.
• Inheritance or Protocols:
  Extend, specialize and join state and node classes.
• Parallel Task Processing:
  Multiple nodes can run simultaneously
• Dual State Management:
  • State with automatic change extraction and conflict detection
  • Shared state accessible by all nodes, protected via explicit locking
• Flexible Routing:
  Define simple node-to-node edges or dynamic routing based on functions.
• Streaming:
  A standardized interface for streaming data between nodes.
• Hooks Interface:
  Customizability and predefined interactive step-by-step debugging class.
• Error Edges:
  Configure node error handling in the graph.

Installation

PyPI

pip install edgygraph

Python 3.13+ is required

Example Workflow

Import Classes

from edgygraph import State, Shared, Node, START, END, Graph
import asyncio

Create a State

class MyState(State):

    capslock: bool = False

Create a Node

class MyNode(Node[MyState, Shared]):

    async def __call__(self, state: MyState, shared: Shared) -> None:

        if state.capslock:
            print("HELLO WORLD!")
        else:
            print("Hello World!")

Create Instances

state = MyState(capslock=True)
shared = Shared()

node = MyNode()

Create a Graph

graph = Graph[MyState, Shared](
    edges=[
        (
            START,
            node,

            END,
        )
    ]
)

Run Graph

asyncio.run(graph(state, shared))

More examples can be found in the examples folder