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.5
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.5-cp313-cp313-win_amd64.whl
| Download URL | aria_engine-1.4.5-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
436a12c71f9c264056846eda9d61cdbcc390e4bf725ac16263b7bdd79e32104f
|
|
BLAKE2b-256 checksum How to use checksums |
85018de71660c72d0b3317741b45d50fd13d89ac797ef8b8b6d83c57a5a2d63d
|
| 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.5-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.5-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 |
2b0ae4d63ac28a03c225c20660c1f4707216d29d1ab8b7a139e2bb845c842113
|
|
BLAKE2b-256 checksum How to use checksums |
97bcbbc0a1b86730930ab8db3467bf90aec15e9d258c2b53f5ead620e4de7f9d
|
| 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.5-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.5-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 |
d4c4f8ae76f4bd3bf363547a785402424ce4c02c9774110f8880facd07f7b535
|
|
BLAKE2b-256 checksum How to use checksums |
064b3a37d3396a80149efd3696815b628e9b546477f14fb3d07d35cee069f8a3
|
| 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.5-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.5-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 |
94b13f749c1caec48500480b7572837993560670ddf9ca06db668376db655883
|
|
BLAKE2b-256 checksum How to use checksums |
bd7d8c36adb77e1c15e1292f7dbccf7a4035ea557c48683b3b9421c78ee0dc31
|
| 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.5-cp312-cp312-win_amd64.whl
| Download URL | aria_engine-1.4.5-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
ab788bed8fe3d56e9b4829b3095cab3e2367209ce14ce77c17e00a6bf07120c8
|
|
BLAKE2b-256 checksum How to use checksums |
5842920a97b55832982ed2ed3a87e7af0328b491156c160239b296609ac036ae
|
| 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.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.5-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 |
17d77d5b36c361696b62a561b0201d6ff05139e45bd04234bffff51c25eab3cd
|
|
BLAKE2b-256 checksum How to use checksums |
8cf3eefc3f6fe31d14dbe73baf0121ba7c4a32590f3da3cf01940e809a43a0e4
|
| 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.5-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.5-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 |
72f058fcdcd23ae12ec9bc251cdb5d8974f9aa312cd1785c8d77f80b80e2fd80
|
|
BLAKE2b-256 checksum How to use checksums |
997d02d14b9b1b3838d717e6bff26beb55ad1a58db63eab753f7da45442be04e
|
| 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.5-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.5-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 |
fc6e55e7a32d6ac512b1fadd83193fc192375a4f822edf9c551356feae06bce2
|
|
BLAKE2b-256 checksum How to use checksums |
09739b395c8022e782d84abc6269dd400725c6c4fd019c932cdf5e5c720a990d
|
| 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.5-cp311-cp311-win_amd64.whl
| Download URL | aria_engine-1.4.5-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
259d9366d4522f49471b9502b87d6c75dc81a3327608ff02c75621523474ce54
|
|
BLAKE2b-256 checksum How to use checksums |
da2ebee9ddb1d5ff9ec1023e616e7caac73cb6e93496038c43c38e8d034483db
|
| 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.5-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.5-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 |
d77fe6d0f9ffaee3b3bb7ee8806ac27267c6cf26a866d7373d64de7a175b816f
|
|
BLAKE2b-256 checksum How to use checksums |
b1f538a99f1980ce02da17eb7abf1c92d4e6c522b92adeb571aa2ed4d81430e8
|
| 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.5-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.5-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 |
2c74b611f749ad8c7c7bf4d9fe930fa2af34dc979de45b980717146b25b66c89
|
|
BLAKE2b-256 checksum How to use checksums |
6743261dcc38ad133ca68d04b80de92dee5266e7f088f5e65fe61df18404e27d
|
| 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.5-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.5-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 |
f4ba86140c2613ade36ec9bb2d4982921449d68eed0fba6fb67436f62467fb95
|
|
BLAKE2b-256 checksum How to use checksums |
962fd3d946e92a590af332e3a3dec4c0a037d0c481fd2488f262b18f9be43a04
|
| 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.5-cp310-cp310-win_amd64.whl
| Download URL | aria_engine-1.4.5-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
fa0961f69731db96439637ea963a4ee5879e23d0e4b6aaca11301ea9e69f8fe5
|
|
BLAKE2b-256 checksum How to use checksums |
824b2054c4d023b0cae8edc0287434bb74d30c072ff9229983e0f313f3ed17b9
|
| 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.5-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.5-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 |
6c6a8c07c81b32739288f6f60b5df668a1e50e6f40d436c63d175a4df3b4a6d7
|
|
BLAKE2b-256 checksum How to use checksums |
cdd1a00282c61c0a41f322887036f5aeef65afa7f8f6bd536070efe6da47473b
|
| 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.5-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.5-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 |
c6589a03327e1e16cb4919dd55903b710e82d2565e9a0582373ddd0a0404a504
|
|
BLAKE2b-256 checksum How to use checksums |
78868701a49f3ad827cc1ed943a47017f250a2067af5b7569afcbdc6cdd290e4
|
| 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.5-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.5-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 |
3a818bc0bd970a580ecc61939cf1eb5cffdb8aec08d0005b6b25a0a20d03d928
|
|
BLAKE2b-256 checksum How to use checksums |
bb21fcfd24af2cb3cc4f4b5eedb7cb6042417e756d30ce80d0a061d491f978fe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
