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.4.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.4.0
File Size Uploaded Provenance Actions
apixis-1.4.0.tar.gz 292.4 kB Without provenance Details for apixis-1.4.0.tar.gz

Built distribution (wheel)

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

Total release size: 376.9 kB

Release files / apixis-1.4.0.tar.gz

Download URL apixis-1.4.0.tar.gz
Size 292.4 kB
Tags Source
SHA-256 checksum
How to use checksums
e69f05c0ee94c3bdf611a52911d82a6c8d5e6cdc6a11531e02bdc50e2e3ee453
BLAKE2b-256 checksum
How to use checksums
becc4df97cd73258746aec1205ed5ffe21944ae786a8e169861b97801c6c8e4f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.7

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

Download URL apixis-1.4.0-py3-none-any.whl
Size 84.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
caabd0c964749d71698ea75f4207a7500c10da4f95df2ac06c8496e5f06af048
BLAKE2b-256 checksum
How to use checksums
72a5dc2bd687f4aebf6b1dd16c85f1293ef6a189120c1194b7486dc440068559
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.7

Security for apixis 1.4.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