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.2.1
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.2.1-cp313-cp313-win_amd64.whl
| Download URL | aria_engine-1.2.1-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
341bc4eec112603f8b981c4cdaef5d8bc923eaa517745e22d275c2c10e9da9b7
|
|
BLAKE2b-256 checksum How to use checksums |
4312891bbb3b83394574e40e4d88259abd38d525d7094f6f9bce3bc3754db9e2
|
| 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.2.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.2.1-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 |
5ae6aa3f5ddb55253b667c98d2f84d26488390531315b6a62082b77d034fc51a
|
|
BLAKE2b-256 checksum How to use checksums |
3f17347e2237b2f15618c101995f4fbe84dcdcda70aa436fef78b1ea30fdb2e6
|
| 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.2.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.2.1-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 |
91c7c0943fa3a14555dcdc4f016edd1476ee94d50a6bbb0296116f5b96ca8116
|
|
BLAKE2b-256 checksum How to use checksums |
abbeebf0309d7b6be01c7fc0f6c84cb034e43c507b2fd22bca2ce3ee3088fbba
|
| 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.2.1-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.2.1-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 |
14df3fbed30d47922664779aea3def6bcab6e8133a17f0997262371dd3decc4f
|
|
BLAKE2b-256 checksum How to use checksums |
4a77d63fb19255337e479be8c7b3ea41cce0a8848cfe8eb2925357ce766a5bfd
|
| 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.2.1-cp312-cp312-win_amd64.whl
| Download URL | aria_engine-1.2.1-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
ae5268b47877d9c575f99e720851870b7863aa6e26751cca3f2fc92a746e5bc4
|
|
BLAKE2b-256 checksum How to use checksums |
e87d5e9de0257895b185c9aba00c87333886e3b3d9d43246988190b8bf54a7c2
|
| 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.2.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.2.1-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 |
5252ba220dcbf1ccfd85ae663e1b09d005aecefa24cec14ab5636df33bbddd91
|
|
BLAKE2b-256 checksum How to use checksums |
13c4009b2fa1a1402b321f7b2acb9cc8a51e6bce1a03fb8c874f00fc44110d39
|
| 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.2.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.2.1-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 |
7f1f79661bb89332054a77cf7fa225656cedc05985f882b1384c81c1da2a72a3
|
|
BLAKE2b-256 checksum How to use checksums |
880eecf1e04f5384a765161249c9e3e09533091d4271e2c769398034d6a4f7b5
|
| 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.2.1-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.2.1-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 |
0fc310c4477b366f46ec76410e3f2cbe58667dbf6382b6ec6abf1b135942f654
|
|
BLAKE2b-256 checksum How to use checksums |
9757f25853574cd735a0e8a21a71c8eb100533fd6e3c5d85c62b27a81a06a2ec
|
| 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.2.1-cp311-cp311-win_amd64.whl
| Download URL | aria_engine-1.2.1-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
ed2e816a3b6bd70d50a658351a070a098703b6f1e0e71b18c410be7482aa1379
|
|
BLAKE2b-256 checksum How to use checksums |
d2e3421563594ffd55f694866ea6e604c1bf996a573c41657a6e99479b606b17
|
| 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.2.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.2.1-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 |
d7c957dee5a7dcfddfbdade40bab3e87170a74646eaa3ff2f29963656abae263
|
|
BLAKE2b-256 checksum How to use checksums |
ca8580800cc4f32eb24df9ac6427f6463be890b7ecdebde163937141cf8f5324
|
| 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.2.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.2.1-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 |
a52650bdf2bbc34a737984bae9ddd801703163fe038154bcefe791192c78e9db
|
|
BLAKE2b-256 checksum How to use checksums |
d02bef462299b7eec1ae5a1fb085bc6a75421c4764e32efcb36cb639eb823c04
|
| 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.2.1-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.2.1-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 |
33218b4e0959cc39499677e6752092f13b33d6e9f0ed69f0a260053fb7805e78
|
|
BLAKE2b-256 checksum How to use checksums |
692191def723c24f94c931c83749d30cf2762e7ddef689a8a0d1493a5efffc3e
|
| 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.2.1-cp310-cp310-win_amd64.whl
| Download URL | aria_engine-1.2.1-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
82a604d4988ab19cbcf969161a06471b3c73376503f4575a251b2dc8382c5320
|
|
BLAKE2b-256 checksum How to use checksums |
93148ff2cc152a1cfb617079a4760954070bbe444b326f3bc7d3d9dcc2bfc057
|
| 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.2.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.2.1-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 |
f3682f5b4d497659851e76d4bbb0e7c40ab78a09ce69586632941bbd7e432013
|
|
BLAKE2b-256 checksum How to use checksums |
b4f1db6d487e3f00201a7d40f21c77c1710d80820344da8c9ec56ab4a8b85e1f
|
| 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.2.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.2.1-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 |
aae1dd32fc25f3e1b43d30e52fd5784e59d30e800fdc565cda32383547cc1658
|
|
BLAKE2b-256 checksum How to use checksums |
970bab7110b2bd82f27789d795b108c888efd2eeac7415263b0e98cead83ec8c
|
| 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.2.1-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.2.1-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 |
0f74575f01305cb1cd1b1c86aaa9ed8a239d4f67121ce838e1449705241adf45
|
|
BLAKE2b-256 checksum How to use checksums |
9a24c7092eb0a205dfbcfb60b6b7c91945449afa1efce1d40dea857a42fdbea5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
