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.6
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.6-cp313-cp313-win_amd64.whl
| Download URL | aria_engine-1.4.6-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
394b6851685ea1e7052c412934df0c5db4d3742741c0a223e8cbf1392981801e
|
|
BLAKE2b-256 checksum How to use checksums |
b8f7c58e4801ff663fe60761eb89cf52be4bf783eef1d317a4d14af54bcd439a
|
| 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.6-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.6-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 |
21b627c14c2a76d6886fc9df95c5596cce7985c5177e7c56c38dcd289370f0d7
|
|
BLAKE2b-256 checksum How to use checksums |
78b1c3fab0fb7a99c79986078f627a70e77d57bfcbbf5e68967f5997f9191625
|
| 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.6-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.6-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 |
3172c9225f6534cb95fff62ca0289eb7ab48dc19cc2e3143d7b59a6ec8ed0e8d
|
|
BLAKE2b-256 checksum How to use checksums |
5c25b13ff058d8694c95ffdb9e6f49a9c60d8d09d49a874d5d5e73c0484f95c8
|
| 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.6-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.6-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 |
e83a09a891bfbe6c5ca9a6d491ddd676b6ab00f05583019fbf036517df83c0c1
|
|
BLAKE2b-256 checksum How to use checksums |
66a1ef72f1137f8c4fde92b12802c48ebc1b5ff4aba4a638ec57611afe1b9090
|
| 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.6-cp312-cp312-win_amd64.whl
| Download URL | aria_engine-1.4.6-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
330a2f207213011c982c65079c9da7c5527245a0321f3750d40389e9c550103a
|
|
BLAKE2b-256 checksum How to use checksums |
22111703538a13371febdf8ec703607a0dab2ecc4849ee5edf9db39f07adce19
|
| 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.6-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.6-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 |
28d801ab06e44cbf46dcfa48e33348c125d01e2e6bd968e2ea0e20bb3d7dfa45
|
|
BLAKE2b-256 checksum How to use checksums |
aef37cc118e072b8d6c18fd568fa1aaecf20933775d898d0a0b59d6484363c27
|
| 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.6-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.6-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 |
0ffd9f42da6b223ec8ca03d47c0d30daff2f0a6b89c85a7cf2b0a3253ca1890a
|
|
BLAKE2b-256 checksum How to use checksums |
bc96a6078d34f31ca76b57176e6b652221d84c5f98849b1321f610069dac0b88
|
| 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.6-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.6-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 |
0e114ac407932d87a7d96c894935973e156d17eeffee0c3c137f3aab2a734c66
|
|
BLAKE2b-256 checksum How to use checksums |
8979d6f94caa5d2165b8dc87727d9dafe64473672452aebd101df04853556890
|
| 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.6-cp311-cp311-win_amd64.whl
| Download URL | aria_engine-1.4.6-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
c8af6d8ab74d8e93033081f8229d6dc909e3ec5549fb4afbfb15bcf97f14a4b8
|
|
BLAKE2b-256 checksum How to use checksums |
fe4dc72939e973135e324f395bfa49a76edddab353218af512f50d6323ab7d86
|
| 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.6-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.6-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 |
d0251d8e335d77ec1a078f64a296bc851e934dd8afb546bb85bf67f1749185b5
|
|
BLAKE2b-256 checksum How to use checksums |
f773641a8b10692cab8fbe94c5c5556d5caf4d176859ebf82f09e62d6db7b5d4
|
| 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.6-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.6-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 |
d8b648743da7095a14258d04351daa65c66d21e7d9a17b1b95c2ff42a4741a02
|
|
BLAKE2b-256 checksum How to use checksums |
5dbdad6af8292c2d06e04aab5480f7367e79dc911fe84db6c37bb9d613cd8042
|
| 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.6-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.6-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 |
d8f22be2507fb3249840c141911a43edf487861bdd4c5275c14f4fd3115c1f4b
|
|
BLAKE2b-256 checksum How to use checksums |
78ac6519822cddf55121b696d3523798c183b69ac30bd16366ab10e827cd3ea5
|
| 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.6-cp310-cp310-win_amd64.whl
| Download URL | aria_engine-1.4.6-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
7a1d0d8a4c07d1c75d502266c71bb21e6f38e73d93e248a4b0dbdd0efb0b97aa
|
|
BLAKE2b-256 checksum How to use checksums |
8b8f427dd21389396883ca489909f3196cd8c5c3339c2bfcfe16d21aae0269e8
|
| 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.6-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.6-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 |
6340cf846cfeb4b588a7316d0bcd5d087196f853c56ac483ff4ff82d146a5344
|
|
BLAKE2b-256 checksum How to use checksums |
59f3a708d0e1a324db84ab0a0d2406fc10181da1f550927237646a70e54ca3bc
|
| 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.6-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.6-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 |
07ca77066f76228c2ae3863cae1c97418805256a9e2beae26ec73ed3c33f51de
|
|
BLAKE2b-256 checksum How to use checksums |
f280524f15f4e6c714f577f0c9f0561b3d966a5555c10aace204493ca9233c90
|
| 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.6-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.6-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 |
cbe5505395506198db6cc5c50b106d1e72221ac02b52f94cff301a51f37de3dc
|
|
BLAKE2b-256 checksum How to use checksums |
c1d15d768408a86c1fe9782a0147eb745558869ec31a19481e5f36b8b597ed79
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
