Skip to main content

APIXIS

中文 | English

面向 Python asyncio 应用的事件驱动图编排。

PyPI Python License

源码 · 问题 · API 参考 · 示例

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

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

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

安装

pip install apixis

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

python -m pip install .

如需开发和发布工具:

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

使用 uv 时,请使用 uv sync --extra dev --locked 和 uv run --extra dev pytest。 运行静态代码检查:uv run --extra dev ruff check .。Ruff 检查常见代码错误和未使用的导入等问题,不执行静态类型检查。

项目采用 src 布局,测试位于仓库根目录的 tests/,所有开发命令均在仓库根目录执行:

src/apixis/     # 可安装的 Python 包
tests/          # 单元、集成和性能测试
docs/           # 项目文档
scripts/        # 基准与安装检查脚本
pyproject.toml  # 构建、依赖和工具配置

快速开始

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())

文档

许可证

根据 Apache License 2.0 授权。请参阅 LICENSE。


APIXIS

English | 中文

Event-driven graph orchestration for Python asyncio applications.

PyPI Python License Discord QQ群

Source · Issues · API Reference · Example

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 ruff check .
python -m pytest

With uv, use uv sync --extra dev --locked and uv run --extra dev pytest. Run static code checks with uv run --extra dev ruff check .. Ruff checks common code errors and unused imports; it does not perform static type checking.

The project uses a src layout: the installable package lives in src/apixis/, and unit, integration and performance tests live in the root tests/ directory. Run development commands from the repository root.

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

License

Licensed under the Apache License 2.0. See LICENSE.

Metadata

Release files for apixis 1.1.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for apixis 1.1.7
File Size Uploaded Provenance Actions
apixis-1.1.7.tar.gz 252.0 kB Without provenance Details for apixis-1.1.7.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for apixis 1.1.7
File Interpreter ABI Platform Actions
apixis-1.1.7-py3-none-any.whl Python 3 none any Details for apixis-1.1.7-py3-none-any.whl

Total release size: 320.9 kB

Release files / apixis-1.1.7.tar.gz

Download URL apixis-1.1.7.tar.gz
Size 252.0 kB
Tags Source
SHA-256 checksum
How to use checksums
8d63109b6f487fa72528963b89c6002639c6b8e0c25020da14621febe69a1225
BLAKE2b-256 checksum
How to use checksums
e57c6663484288848187513bea905c3ed63ded0868d939a7e73e1431e51a48bd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.12

Release files / apixis-1.1.7-py3-none-any.whl

Download URL apixis-1.1.7-py3-none-any.whl
Size 68.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
08a6e122addc390ec65f43b34110f7d9feb3a6c3bc8159cff7da2d9b06a8ac2d
BLAKE2b-256 checksum
How to use checksums
6fc732a81d793bbd951830491157dd2434ab1ae524adf34e06c22427255efa93
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.12

Security for apixis 1.1.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page