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, a local event queue, and asynchronous publication and waiting across threads;
  • 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.3.0

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.3.0
File Size Uploaded Provenance Actions
apixis-1.3.0.tar.gz 286.3 kB Without provenance Details for apixis-1.3.0.tar.gz

Built distribution (wheel)

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

Total release size: 369.0 kB

Release files / apixis-1.3.0.tar.gz

Download URL apixis-1.3.0.tar.gz
Size 286.3 kB
Tags Source
SHA-256 checksum
How to use checksums
8f5e6a73a5a136b35528636c9ae2891dd74a3f9b07f725779ff2a363e0138e99
BLAKE2b-256 checksum
How to use checksums
52878f64f0a04f2028527d2734af209edc1a30aea5558304a46cc14d50571c9d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.7

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

Download URL apixis-1.3.0-py3-none-any.whl
Size 82.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
755558a4ab1a1804344ece1bdd44c0dd54f189b59f7f3b5170c7f4fe04295e2d
BLAKE2b-256 checksum
How to use checksums
65a37c18c2bf66c909de0c570499d8f8f430516c6a0e0fc47b7e2d692d68b069
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.7

Security for apixis 1.3.0

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