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.2
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.2-cp313-cp313-win_amd64.whl
| Download URL | aria_engine-1.4.2-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
b0355f6486eb1e362a2a876a0403b97cd110b59fe0a22ebdfd1b211559729904
|
|
BLAKE2b-256 checksum How to use checksums |
771ed8cb488c30c1aeb9c25c8fb218314e56584094bfaa8c25d0bb8c14122e1c
|
| 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.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.2-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 |
daa649bc38e659aeee6ec012d71bf7b3e2f6cf1bf384275ab6ff12a298eec7ec
|
|
BLAKE2b-256 checksum How to use checksums |
c2cc6ee70d64320a7456cb1f115e574790e730920311f6b9fd1e1a5237372b57
|
| 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.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.2-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 |
504d45b3c07b0ec0614477d7d51753c96c0583fcd5382b1cc830c21ab9404e5a
|
|
BLAKE2b-256 checksum How to use checksums |
005fdb2e5968b456511f5b971119d0619cb59326e5774680b74678a3113ab5bd
|
| 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.2-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.2-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 |
c4b50dcd3c9901a36a0cf43ebc34f97789e87677c93ef64942bd5371d2f72bb5
|
|
BLAKE2b-256 checksum How to use checksums |
4d456d4dd01ab58cfa35b17b58919473c596e1be4e5a820e131019df49fcc771
|
| 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.2-cp312-cp312-win_amd64.whl
| Download URL | aria_engine-1.4.2-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
243ce62318ee17fb2471c72035388584d1798b63630d3b7403d0196aceca4ddf
|
|
BLAKE2b-256 checksum How to use checksums |
571ae3d929d1921350e52bc4ef09a1b571c104e6cf1abbf40e37a1aa7e274e19
|
| 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.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.2-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 |
683419fb453d53979087bdb390be2a817b1faf06d515a44264ad6fd64070c680
|
|
BLAKE2b-256 checksum How to use checksums |
b89dd3c19db5abf8d2a0da4e327491f3a6baacbab9c6c9f0923d91e92398c887
|
| 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.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.2-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 |
f99916cb2adcaf6f0ad92ae220b1f1af9f53641379f4e46f69b9c1a4b80ef9fa
|
|
BLAKE2b-256 checksum How to use checksums |
e0e3714b239399710776664b48f492ae5dad6d60f3a61a8a1bacbeb16254f14e
|
| 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.2-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.2-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 |
4e100b42841fea8f86c734e78556a8845030234bdd945608f4e94e42dcbebeb9
|
|
BLAKE2b-256 checksum How to use checksums |
a11c06ec54709bf89f6ab35a4b295ef21ec7cd17ad0e70aa96271e17ed918d65
|
| 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.2-cp311-cp311-win_amd64.whl
| Download URL | aria_engine-1.4.2-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
7218506c4d7729a6d278e21a600ebf64a4410924a5eb4f20d8663e156695b55b
|
|
BLAKE2b-256 checksum How to use checksums |
227a139d7042597b97eee07eee60bad362617079c6e12be64356d1225c1a8b90
|
| 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.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.2-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 |
35bac95cfa4210c497298f1f13816f849d5d2f77fe22ef770b7b584f3ed4fce9
|
|
BLAKE2b-256 checksum How to use checksums |
e7c341891703ab911e506fe1e514bd4d41628900bdee932e7126067336b4a291
|
| 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.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.2-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 |
afff650d47900a6e3b73b2b01accf82299e7e11fdd5d8de0561a15ed370b6976
|
|
BLAKE2b-256 checksum How to use checksums |
98b62e0ee344307262291e822215fad9ae69a012330752f520d425f0680ae9b4
|
| 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.2-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.2-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 |
edcc17e21534a0daccb6ab0d04e654a2b5cc5920e476410ff256d7c1bbca6cf6
|
|
BLAKE2b-256 checksum How to use checksums |
291afda86c49c84e0251cff1ca830da858deb747faadb6673058b1a683d9d830
|
| 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.2-cp310-cp310-win_amd64.whl
| Download URL | aria_engine-1.4.2-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
18b63cf3e09551a96516474dffb378b33d59e42f140c8fe6316cb0985123ee9c
|
|
BLAKE2b-256 checksum How to use checksums |
d05c352d47d4cd0e8a7b2ab92b0985e4d67913b890d3bc7512409329d2723f5f
|
| 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.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.2-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 |
dc5a62da0412dec4ff6f94b21145969aa99c0d50aa77e43e1c882cb55a8ffeba
|
|
BLAKE2b-256 checksum How to use checksums |
e3fb57cf63a13f9f9e28f87c25952ccb1a2a7cd0afd345af2b33b1c7e627585c
|
| 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.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.2-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 |
a83fde44d41145dfd0ff31cfbe1b5979e5c8df802faf0e3b85845eb27400210a
|
|
BLAKE2b-256 checksum How to use checksums |
1dd46756a840206ac9a87bae4f5badbdabefd6d9d2f46e2e10d913a3dbff4bd6
|
| 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.2-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.2-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 |
fd3d0e92191b50a22d36f70baf55d0c6450fdbb9f9e8d937597d277885507dbb
|
|
BLAKE2b-256 checksum How to use checksums |
5c79afdaca7e996d3e4213a07b765c6fef1ff9d4b80b07145dd5c48c3f89a53d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
