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.4.8
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.6 MB
Release files / aria_engine-1.4.8-cp313-cp313-win_amd64.whl
| Download URL | aria_engine-1.4.8-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
6dca0f6ae0209f154c3961d9a9576680fddc34c859afcd0d1b6125a8c8fa9214
|
|
BLAKE2b-256 checksum How to use checksums |
d22239b366c755bb5a1aeefee026f9876f0863fc82a1a6f4c0907e776681a576
|
| 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.4.8-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.8-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 |
55860fd80b41b840acbacfdb60c99f0cffb1a830f95cfc5e489ee6c4eaf1e1da
|
|
BLAKE2b-256 checksum How to use checksums |
ad138c5b3d2e52729bc31d54b6b8e2510ec04ac7c9b2ea0c1c243f7db358f8d4
|
| 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.4.8-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.8-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 |
9b808a02f0c7939ff6d750e1b56aba92eaf6158344d2d9f59c5f883e5b9dab7a
|
|
BLAKE2b-256 checksum How to use checksums |
b7b854d1ffa51730f88d1f7b78699e5eaf8cb3e68fb93b438087272c658de48b
|
| 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.4.8-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.8-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 |
836953c41469762fa7ae4b0e78c2f8a20e4ede9d10f4cba0b3c1fc84fdeb6769
|
|
BLAKE2b-256 checksum How to use checksums |
d21aa6df09d63fb598029a0dd1db74b60e531c3213a75594d4dd2c5680ae4a03
|
| 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.4.8-cp312-cp312-win_amd64.whl
| Download URL | aria_engine-1.4.8-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
730d20462ce1bcd114bd10f490e6a2aab59a149e3fa37763d64dc0df796ecc1c
|
|
BLAKE2b-256 checksum How to use checksums |
199b73dd53e7feba2af9c7049aa0e0480f898b58924ff3094ddc58650ae550d0
|
| 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.4.8-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.8-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 |
bc5e8655dff9ae676877981a5509fc99da8ba4caba097af834354277092d6313
|
|
BLAKE2b-256 checksum How to use checksums |
af48662d7e5cffc612ddde9bc0e0132fad7f9fc0623b41fd8b09a31d950aed12
|
| 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.4.8-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.8-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 |
f50fa897131d74d974b42f566a24290fdd679269f23f1e5d1a549a35814794f4
|
|
BLAKE2b-256 checksum How to use checksums |
5cdb0486525f9d2a7b033886a3a0234712bac5b3e8f4412605595b30ced4d382
|
| 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.4.8-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.8-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 |
d1f3c6a8a6ca5d13db1b1b3a73de07ba8521b4fd0493d52d7b0eb628e560b97a
|
|
BLAKE2b-256 checksum How to use checksums |
6a6b209eff352624b59772a335bfe5b6dbc0a80205c5ea12d24a7033ae112b12
|
| 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.4.8-cp311-cp311-win_amd64.whl
| Download URL | aria_engine-1.4.8-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
3ec2ebe999232154dd6f1ae12c459fe6384addf4ad54c33715c5c35c46091a24
|
|
BLAKE2b-256 checksum How to use checksums |
1920c4c29b9083f132be3c6e602c592917b549166f00ed6a7d7e8a5c627c707e
|
| 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.4.8-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.8-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 |
26a08f55040eddc2e4cf5db9d772611cf16ba47762a842a7c14798921497bce3
|
|
BLAKE2b-256 checksum How to use checksums |
d763f7d3ad82a3f4f3a84f17c2b8072adaf86d3bf941312f461a02d0603c5d0e
|
| 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.4.8-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.8-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 |
6f61d913345c19dad0f14fec4ef5798fdb418d9d23cc013d20cbab06d70ce2e2
|
|
BLAKE2b-256 checksum How to use checksums |
8ba52421e7083f8508952fb527bd7ddf19b83ee910eb85fd37d7cedea9f0aec4
|
| 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.4.8-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.8-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 |
934bbe4170e9c17d21a8c5f6ff8698219a23f8059115ea9b9402f7f7dc5fd89e
|
|
BLAKE2b-256 checksum How to use checksums |
b1a47d01f9e32053cda72aec55003572e4157a9ed9f9ff97a8ed1fa52b7e0fe8
|
| 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.4.8-cp310-cp310-win_amd64.whl
| Download URL | aria_engine-1.4.8-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
008d582356c32172168a887bc52aeb766c04c149ea179313a88d39e3d1d46aec
|
|
BLAKE2b-256 checksum How to use checksums |
1677531cdee0937801df104a5fc7e8b47060fba315e526382a93c044c5c45cef
|
| 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.4.8-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.8-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 |
c7239b17a111a93aa0fc8bc859611e0d3caf243c61b8ea96c36e6453520d1f20
|
|
BLAKE2b-256 checksum How to use checksums |
e72cdf94ec71653a9a8df86ed209990cd76cce5476f0405b9559f2bff4883f4f
|
| 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.4.8-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.8-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 |
e09542566416ee1d80c20d9b461b9117711047b2423b82493efeaf67c119390f
|
|
BLAKE2b-256 checksum How to use checksums |
6b153cbaf9777c214bcfaa23a04e43f8f375fe0830cc731e4a9610f643e66957
|
| 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.4.8-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.8-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 |
888a64bb863c3344b28f24d64cc37772c272bfe5fb7cf2231ad0b2a9b306a992
|
|
BLAKE2b-256 checksum How to use checksums |
f22fc037fd6e6df6a825ddbedc41fc9633af6ec09bf99bfdded851864cce62ac
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
