https://github.com/yeongseon/azure-functions-durable-graph-python

Manifest-first graph runtime for Azure Functions Python v2 using Durable Functions — Part of the Azure Functions Python DX Toolkit
https://github.com/yeongseon/azure-functions-durable-graph-python

azure azure-functions durable-functions dx-toolkit graph orchestration python serverless workflow

Last synced: 1 day ago
JSON representation

Manifest-first graph runtime for Azure Functions Python v2 using Durable Functions — Part of the Azure Functions Python DX Toolkit

Host: GitHub
URL: https://github.com/yeongseon/azure-functions-durable-graph-python
Owner: yeongseon
License: mit
Created: 2026-04-02T12:52:29.000Z (2 months ago)
Default Branch: main
Last Pushed: 2026-05-14T08:25:14.000Z (25 days ago)
Last Synced: 2026-05-14T08:37:04.946Z (25 days ago)
Topics: azure, azure-functions, durable-functions, dx-toolkit, graph, orchestration, python, serverless, workflow
Language: Python
Homepage: https://yeongseon.github.io/azure-functions-durable-graph-python/
Size: 829 KB
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.ja.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Support: SUPPORT.md
- Agents: AGENTS.md

Awesome Lists containing this project

README

          # Azure Functions Durable Graph

[![PyPI](https://img.shields.io/pypi/v/azure-functions-durable-graph.svg)](https://pypi.org/project/azure-functions-durable-graph/)

[![Python Version](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](https://pypi.org/project/azure-functions-durable-graph/)

[![CI](https://github.com/yeongseon/azure-functions-durable-graph/actions/workflows/ci-test.yml/badge.svg)](https://github.com/yeongseon/azure-functions-durable-graph/actions/workflows/ci-test.yml)

[![Release](https://github.com/yeongseon/azure-functions-durable-graph/actions/workflows/publish-pypi.yml/badge.svg)](https://github.com/yeongseon/azure-functions-durable-graph/actions/workflows/publish-pypi.yml)

[![Security Scans](https://github.com/yeongseon/azure-functions-durable-graph/actions/workflows/security.yml/badge.svg)](https://github.com/yeongseon/azure-functions-durable-graph/actions/workflows/security.yml)

[![codecov](https://codecov.io/gh/yeongseon/azure-functions-durable-graph/branch/main/graph/badge.svg)](https://codecov.io/gh/yeongseon/azure-functions-durable-graph)

[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://pre-commit.com/)

[![Docs](https://img.shields.io/badge/docs-gh--pages-blue)](https://yeongseon.github.io/azure-functions-durable-graph/)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

他の言語: [한국어](README.ko.md) | [English](README.md) | [简体中文](README.zh-CN.md)

> **Alpha版のお知らせ** — このパッケージは初期開発段階（`0.1.0a0`）です。リリース間でAPIが予告なく変更される場合があります。本番環境での使用前に十分なテストを行ってください。

**Azure Functions** と **Durable Functions** オーケストレーションのためのマニフェストファーストなグラフランタイムです。

---

**Azure Functions Python DX Toolkit** の一部

→ Azure Functions に FastAPI レベルの開発者体験を提供します

## なぜ必要か

Azure Functions でグラフ形状のワークフローを実行するのは、想像以上に困難です：

- **オーケストレーターの決定論性** — Durable Functions オーケストレーターは決定論的でなければなりません。LLM やツールを直接呼び出すとリプレイの安全性が損なわれます

- **グラフからランタイムへのギャップ** — ノード/エッジのグラフ設計を Durable Functions のアクティビティに変換するには、繰り返しのボイラープレートが必要です

- **標準ランタイムの不在** — 各チームがグラフ定義と Durable Functions プリミティブの接続を独自に構築しています

## 機能概要

- **マニフェストファーストランタイム** — グラフ定義を安定したバージョン管理されたマニフェストにコンパイルし、オーケストレーターの決定論性を維持します

- **自動 HTTP API** — `POST /api/graphs/{graph_name}/runs`、`GET /api/runs/{instance_id}`、イベント注入、キャンセル、ヘルスエンドポイントが自動的に登録されます

- **決定論的オーケストレーターループ** — すべてのユーザーロジック（ノード実行、ルーティング、イベント処理）は Durable Functions アクティビティで実行され、オーケストレーター内部では実行されません

- **条件付きルーティングと外部イベント** — `RouteDecision` によるブランチワークフローと human-in-the-loop パターンをサポートします

## スコープ

- Azure Functions Python **v2 プログラミングモデル**

- `azure-functions-durable` による Durable Functions オーケストレーション

- Pydantic v2 ベースの状態モデル

- グラフトポロジー：順次、条件付き、イベント駆動

このパッケージは LangGraph から独立しており、LangGraph への依存はありません。名前は LangGraph のノード/エッジモデルにインスパイアされています。

## 機能

- グラフノード、ルート、イベントハンドラーを宣言する `ManifestBuilder` API

- 構成可能な実行ループを持つ決定論的 Durable Functions オーケストレーター

- Pydantic v2 モデルによる型安全な状態管理

- 組み込み HTTP エンドポイント：実行開始、ステータス取得、イベント送信、キャンセル、ヘルス、OpenAPI

- マニフェスト派生ハッシュによるグラフバージョニングで安全なデプロイをサポート

## インストール

```bash

pip install azure-functions-durable-graph

```

Azure Functions アプリには以下も含めてください：

```text

azure-functions

azure-functions-durable

azure-functions-durable-graph

```

ローカル開発用：

```bash

git clone https://github.com/yeongseon/azure-functions-durable-graph.git

cd azure-functions-durable-graph

pip install -e .[dev]

```

## クイックスタート

```python

from pydantic import BaseModel

from azure_functions_durable_graph import DurableGraphApp, ManifestBuilder, RouteDecision

class MyState(BaseModel):

    message: str

    processed: bool = False

def process_message(state: MyState) -> dict:

    return {"processed": True}

def finalize(state: MyState) -> dict:

    return {"message": f"Done: {state.message}"}

builder = ManifestBuilder(graph_name="my_graph", state_model=MyState)

builder.set_entrypoint("process")

builder.add_node("process", process_message, next_node="finalize")

builder.add_node("finalize", finalize, terminal=True)

registration = builder.build()

runtime = DurableGraphApp()

runtime.register_registration(registration)

app = runtime.function_app

```

### 提供される機能

1. `POST /api/graphs/my_graph/runs` — 新しいグラフ実行を開始します

2. `GET /api/runs/{instance_id}` — 実行ステータスをポーリングします

3. `GET /api/health` — 登録済みグラフを一覧表示します

4. `GET /api/openapi.json` — OpenAPI ドキュメント

## 使用するタイミング

- Azure Functions でグラフ形状の LLM ワークフローが必要な場合

- 手動のアクティビティ配線なしで決定論的な Durable Functions オーケストレーションが必要な場合

- Human-in-the-loop 承認パターン（外部イベント）が必要な場合

- トポロジーハッシュによるバージョン管理されたグラフデプロイが必要な場合

## サンプル

| サンプル | パターン | 主要コンセプト |

|---------|---------|----------------|

| [Data Pipeline](examples/data_pipeline/) | 順次実行 | `next_node` チェーン、状態蓄積 |

| [Content Classifier](examples/content_classifier/) | 条件分岐 | `RouteDecision.next()`、fan-in トポロジー |

| [Support Agent](examples/support_agent/) | Human-in-the-loop | `wait_for_event`、外部イベント、承認フロー |

## ドキュメント

- プロジェクトドキュメントは `docs/` にあります

- テスト済みの例は `examples/` にあります

- プロダクト要件：`PRD.md`

- 設計原則：`DESIGN.md`

## エコシステム

**Azure Functions Python DX Toolkit** の一部：

| パッケージ | 役割 |

|---------|------|

| [azure-functions-validation](https://github.com/yeongseon/azure-functions-validation) | リクエスト・レスポンスバリデーション |

| [azure-functions-openapi](https://github.com/yeongseon/azure-functions-openapi) | OpenAPI スペックと Swagger UI |

| [azure-functions-logging](https://github.com/yeongseon/azure-functions-logging) | 構造化ロギングとオブザーバビリティ |

| [azure-functions-doctor](https://github.com/yeongseon/azure-functions-doctor) | デプロイ前診断 CLI |

| [azure-functions-scaffold](https://github.com/yeongseon/azure-functions-scaffold) | プロジェクトスキャフォールディング |

| **azure-functions-durable-graph** | Durable Functions ベースのマニフェストグラフランタイム |

| [azure-functions-python-cookbook](https://github.com/yeongseon/azure-functions-python-cookbook) | レシピとサンプル |

## 免責事項

このプロジェクトは独立したコミュニティプロジェクトであり、Microsoft とは

提携・承認・保守の関係にありません。

Azure および Azure Functions は Microsoft Corporation の商標です。

## ライセンス

MIT

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/yeongseon/azure-functions-durable-graph-python

Awesome Lists containing this project

README