Pydantic Graph
Graph and finite state machine library.
This library is developed as part of Pydantic AI, however it has no dependency
on pydantic-ai or related packages and can be considered as a pure graph-based state machine library. You may find it useful whether or not you're using Pydantic AI or even building with GenAI.
As with Pydantic AI, this library prioritizes type safety and use of common Python syntax over esoteric, domain-specific use of Python syntax.
pydantic-graph allows you to define graphs using standard Python syntax. In particular, edges are defined using the return type hint of nodes.
Full documentation is available at ai.pydantic.dev/graph.
Here's a basic example:
from __future__ import annotations
from dataclasses import dataclass
from pydantic_graph import BaseNode, End, GraphBuilder, GraphRunContext, StepContext
@dataclass
class DivisibleBy5(BaseNode[None, None, int]):
foo: int
async def run(
self,
ctx: GraphRunContext,
) -> Increment | End[int]:
if self.foo % 5 == 0:
return End(self.foo)
else:
return Increment(self.foo)
@dataclass
class Increment(BaseNode):
foo: int
async def run(self, ctx: GraphRunContext) -> DivisibleBy5:
return DivisibleBy5(self.foo + 1)
g = GraphBuilder(input_type=int, output_type=int)
@g.step
async def start(ctx: StepContext[None, None, int]) -> DivisibleBy5:
return DivisibleBy5(ctx.inputs)
g.add(
g.node(DivisibleBy5),
g.node(Increment),
g.edge_from(g.start_node).to(start),
)
fives_graph = g.build()
async def main():
result = await fives_graph.run(inputs=4)
print(result)
#> 5
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pydantic_graph-2.19.0.tar.gz.
File metadata
- Download URL: pydantic_graph-2.19.0.tar.gz
- Upload date:
- Size: 44.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2c14333a56c95649f4a18bea17ce043845d39bbb6c1f01c7cafec5eb24d4b66c
|
|
| MD5 |
286ef9d3394cca8c73c087bb53cf6ed0
|
|
| BLAKE2b-256 |
bc7f7ee83afef1f734fd736a43e66e4f0402d24e022fb3c07f83bd75ed8eb0da
|
Provenance
The following attestation bundles were made for pydantic_graph-2.19.0.tar.gz:
Publisher:
ci.yml on pydantic/pydantic-ai
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pydantic_graph-2.19.0.tar.gz -
Subject digest:
2c14333a56c95649f4a18bea17ce043845d39bbb6c1f01c7cafec5eb24d4b66c - Sigstore transparency entry: 2265783677
- Sigstore integration time:
-
Permalink:
pydantic/pydantic-ai@392bc9088e214ea06f2a1b7c650c2b22730a1e4d -
Branch / Tag:
refs/tags/v2.19.0 - Owner: https://github.com/pydantic
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@392bc9088e214ea06f2a1b7c650c2b22730a1e4d -
Trigger Event:
push
-
Statement type:
File details
Details for the file pydantic_graph-2.19.0-py3-none-any.whl.
File metadata
- Download URL: pydantic_graph-2.19.0-py3-none-any.whl
- Upload date:
- Size: 51.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0fae00c8989e56922cd0315f5c576e39ba3cf2fc2e1a980002bd61aa3e0f5cbc
|
|
| MD5 |
14f3744b047142039d0df04359d3835e
|
|
| BLAKE2b-256 |
7532e81690f0110887b6c6fd579390f1baab8e489952e738df6e3a7fa2274cee
|
Provenance
The following attestation bundles were made for pydantic_graph-2.19.0-py3-none-any.whl:
Publisher:
ci.yml on pydantic/pydantic-ai
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pydantic_graph-2.19.0-py3-none-any.whl -
Subject digest:
0fae00c8989e56922cd0315f5c576e39ba3cf2fc2e1a980002bd61aa3e0f5cbc - Sigstore transparency entry: 2265783925
- Sigstore integration time:
-
Permalink:
pydantic/pydantic-ai@392bc9088e214ea06f2a1b7c650c2b22730a1e4d -
Branch / Tag:
refs/tags/v2.19.0 - Owner: https://github.com/pydantic
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
ci.yml@392bc9088e214ea06f2a1b7c650c2b22730a1e4d -
Trigger Event:
push
-
Statement type:
