APIXIS 提供两个可组合的运行时：

• 一个异步事件系统，支持通配符订阅、有序处理器、背压和本地事件队列；
• 一个有状态图运行时，支持命令驱动的步骤、并行节点、快照、流式处理以及中断/恢复工作流。

需要 Python 3.12+。运行时 API 专为 asyncio 设计。

安装

pip install apixis

要安装本地检出，请在仓库根目录运行：

python -m pip install .

如需开发和发布工具：

python -m pip install -e ".[dev]"
python -m pytest

使用 uv 时，请使用 uv sync --extra dev --locked 和 uv run --extra dev pytest。 有关构建和发布到 PyPI，请参阅发布指南。

快速开始

import asyncio

from apixis import GraphManager


def increment(state: dict) -> dict:
    return {"value": state["value"] + 1}


async def master() -> None:
    graph = (
        GraphManager()
        .add_node(increment)
        .compile_graph(entry_point="increment")
    )
    try:
        result = await graph.invoke({"value": 1})
        print(result)  # {'value': 2}
    finally:
        graph.decompose()


asyncio.run(master())

文档

• API 参考
• 事件 API
• 图 API
• 状态与命令
• 工具与异常
• 使用示例

许可证

根据 Apache License 2.0 授权。请参阅 LICENSE。 捆绑的 IdGenerator 组件采用 MIT 许可证；请参阅第三方声明。

APIXIS provides two composable runtimes:

• an asynchronous event system with wildcard subscriptions, ordered handlers, backpressure, and a local event queue;
• a stateful graph runtime with Command-driven steps, parallel nodes, snapshots, streaming, and interruption/resume workflows.

Python 3.12+ is required. Runtime APIs are designed for asyncio.

Install

pip install apixis

To install a local checkout, run from the repository root:

python -m pip install .

For development and release tools:

python -m pip install -e ".[dev]"
python -m pytest

With uv, use uv sync --extra dev --locked and uv run --extra dev pytest. See the release guide for building and publishing to PyPI.

Quick start

import asyncio

from apixis import GraphManager


def increment(state: dict) -> dict:
    return {"value": state["value"] + 1}


async def master() -> None:
    graph = (
        GraphManager()
        .add_node(increment)
        .compile_graph(entry_point="increment")
    )
    try:
        result = await graph.invoke({"value": 1})
        print(result)  # {'value': 2}
    finally:
        graph.decompose()


asyncio.run(master())

Documentation

• API reference
• Event API
• Graph API
• State and commands
• Utilities and exceptions
• Example

License

Licensed under the Apache License 2.0. See LICENSE. The bundled IdGenerator component is MIT licensed; see third-party notices.