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.
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.