aria-engine (Python)
aria-engine 是 Aria 推理引擎的 Python SDK（ctypes 封装 libaria_ffi）。
通过 PyPI 安装的 平台 wheel 内已捆绑动态库，开箱即用，无需手动设置环境变量。
安装（PyPI 发布版）
pip install aria-engine
支持 Linux (x86_64 / aarch64 manylinux)、macOS (x86_64 / arm64)、Windows (x86_64)， Python 3.10+。wheel 内自带
libaria_ffi.so/.dylib/.dll。
用法
from aria_engine import Engine
with Engine("/path/to/bundle") as eng:
print(eng.complete([{"role":"user","content":"hi"}], {"max_tokens": 16}))
动态库查找顺序
_load_lib() 按以下顺序解析：
- 显式传入的
path - 环境变量
ARIA_FFI_LIB（源码安装 / 自定义路径时使用） - wheel 内捆绑的
aria_engine/lib/<libaria_ffi.so|dylib|dll> - 都找不到 →
RuntimeError（提示安装 wheel 或设置ARIA_FFI_LIB）
源码安装（开发）
export ARIA_FFI_LIB=/path/to/libaria_ffi.so
pip install -e .
构建 wheel（cibuildwheel）
bash scripts/build-python-ffi.sh # 编译 libaria_ffi 并拷入 aria_engine/lib/
pip install cibuildwheel
cibuildwheel --platform linux # 或 macos / windows
发布到 PyPI
GitHub Release 触发 .github/workflows/publish-pypi.yml：五平台构建 + twine upload。
需要仓库 Secret PYPI_TOKEN（PyPI API token，project-scoped，owner ariacompute）。
版本号取 tag 去 v（也支持 workflow_dispatch 手动输入）。
1 maintainer
Metadata
1 maintainer
Release files for aria-engine 1.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
Total release size: 29.5 MB
Release files / aria_engine-1.3.0-cp313-cp313-win_amd64.whl
| Download URL | aria_engine-1.3.0-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
593207cea333330183d4af9642ea2b182f40c7b3eba962db645a68d4965cf7f8
|
|
BLAKE2b-256 checksum How to use checksums |
300ee46b78072f0d8ef9b446eb0b752c421816808407ca911d429a5d489331fc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / aria_engine-1.3.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.3.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 2.0 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
16dee36bf8167716f36a009003774b2566060208c531610dd45ae3a08a32b0c1
|
|
BLAKE2b-256 checksum How to use checksums |
8e79fe5c74b0876ae69d17d067f0da92223e6d9c2e011e545c695b57bdd87c71
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / aria_engine-1.3.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.3.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 2.0 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
7cb0e0adca8f5d472ba23e8215143d5ea4654748e1c3d8791014acc6c5675a17
|
|
BLAKE2b-256 checksum How to use checksums |
1ca5ad585ba56b69fc8a899c5779a25729ae107b9644dac9c7490a0fec477b08
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / aria_engine-1.3.0-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.3.0-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.7 MB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
4d5278a9096fad7872c97a4e47617e578a0e346cbd9f3a90e3f7ad09fb61ea02
|
|
BLAKE2b-256 checksum How to use checksums |
0ea33d0c00302fa50e7c51ab26e9981de396dcc012a35d91ffb75c18ac20af72
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / aria_engine-1.3.0-cp312-cp312-win_amd64.whl
| Download URL | aria_engine-1.3.0-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
6b1f1229d354fe42765f0b93f6ce66bdc58fed81bbb0a13e19b44cf0ddf69aa7
|
|
BLAKE2b-256 checksum How to use checksums |
eecdf3a1169d3880cc4661db95040a08d3b3a9284e472ab6e037a1fc8575117e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / aria_engine-1.3.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.3.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 2.0 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
764d44fac307493a1df3bcb492b8febc1956435ab2edccd44d39520c69bdad73
|
|
BLAKE2b-256 checksum How to use checksums |
ca03ef32d3e7518a6d1919a02761cac2ac7a9e41ef6a8cb7a62bbc13ec29ad22
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / aria_engine-1.3.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.3.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 2.0 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
75861e893f66642ae1c6b5f6b32dd3c26a41404e1790955a590678feb279f8db
|
|
BLAKE2b-256 checksum How to use checksums |
27ca95012616325634b364d7a99fb8df111d3d0dfbb5524b644db60205aa9e83
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / aria_engine-1.3.0-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.3.0-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.7 MB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
7b1ea406bfe29ec55e10de19f6e6fe987823413d59a03ba335bd57bbb6ffdb92
|
|
BLAKE2b-256 checksum How to use checksums |
000726d2570075dad969aed932e524630754c22944b96372f611b5fe7426b19d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / aria_engine-1.3.0-cp311-cp311-win_amd64.whl
| Download URL | aria_engine-1.3.0-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
f091a0aea4095d98dff3910c2e824ff204f5602f6471c5147f0719432c934d39
|
|
BLAKE2b-256 checksum How to use checksums |
e5d3f6f4ad8de87d1347ee1b27bdfff79414dbb23ea8f86cf6fb5bd7169bd79d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / aria_engine-1.3.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.3.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 2.0 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
7b8dbb83c737ba8b2601d983ca42d98db5e619d22cc31c4ceee6dc8bd6309a3f
|
|
BLAKE2b-256 checksum How to use checksums |
033cb19584d81a0c0f39fc657d2ca656b3d2cfe6028a63053a4b9c250823f9c8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / aria_engine-1.3.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.3.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 2.0 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
d25d7c59a64682935609a8e833c83e7dc7e798e8807ca196477d2cb8a8231719
|
|
BLAKE2b-256 checksum How to use checksums |
4bc7e9d074ddfb0da83b0f913f54e4cefd141bce1064cd1e94eefeb9acfbfc86
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / aria_engine-1.3.0-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.3.0-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.7 MB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
0f272aa2d7c9955db0cb8f1a19a072034817163732bb8ba2cc5bf8846a02a2b6
|
|
BLAKE2b-256 checksum How to use checksums |
5e670f697c8c84f16f310181c76527512d895de24e3452a0e6869db1019e1218
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / aria_engine-1.3.0-cp310-cp310-win_amd64.whl
| Download URL | aria_engine-1.3.0-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
43693a07d91a6aced88683c113aa763490f6f484ef7fd7f6ac5efd64b93bef98
|
|
BLAKE2b-256 checksum How to use checksums |
3bb51ac75f9676a0f5da90871ceccdc116600819388e656621b0fa9fb32916b8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / aria_engine-1.3.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.3.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 2.0 MB |
| Tags | CPython 3.10 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
7309c6e9a29e0b00be38cd9b48b6292f7a807be5b9f185fc3ac31b635d895f77
|
|
BLAKE2b-256 checksum How to use checksums |
fe9539f3866109d496df84bbed88294ef364ed467fb9b96e48269c398a68be85
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / aria_engine-1.3.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.3.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 2.0 MB |
| Tags | CPython 3.10 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
5f3952adc70d73ef41e047a13614340f827f9de4b066daa667b43130e9424dec
|
|
BLAKE2b-256 checksum How to use checksums |
fa06f366ade8970ac1682d989db4e97f2011a989a247daf3b78cf14d6ca7e4a2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / aria_engine-1.3.0-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.3.0-cp310-cp310-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.7 MB |
| Tags | CPython 3.10 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
3a200b79c559b94f294665c4ed4fdf6e0b27dea21015b11a0ed98473e72c3ba0
|
|
BLAKE2b-256 checksum How to use checksums |
0d20028a873040e78a3bc91b227c819566b60255634a7a962d2120aa4c9a5c07
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
