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.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.4.1-cp313-cp313-win_amd64.whl
| Download URL | aria_engine-1.4.1-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
4a4edf166214f9db696d88b9653d2b8f0e79ca15bf4ffd16b5222c70578e54dd
|
|
BLAKE2b-256 checksum How to use checksums |
f5f83f731b97e40fbb05a0cbe88508f5b4cff038d9581b4237e4afcf906ca4b6
|
| 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.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.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 |
da179a68e82e0b94e08805da498b3d2dfe93553bcafdbfcae1cbee6e35b74b0a
|
|
BLAKE2b-256 checksum How to use checksums |
e2d9813d7680870c0dca161e7ac8d730f78a27c332e0ce87c2b96451957e9f1a
|
| 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.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.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 |
9341c6233b1695d9b2b40a4a095e7fee703a3166ce4b490f776d3d2109ea596e
|
|
BLAKE2b-256 checksum How to use checksums |
f3966f47c7801addcd73b5cd8bbca774bbbd7ce0c370b18144725e2cc64e3e85
|
| 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.1-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.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 |
69a14987fe481c92cd7a78a0e63a024e1bb7b901b04b2d9493e20c08add1d8f7
|
|
BLAKE2b-256 checksum How to use checksums |
28c78dd11e2f4a72b644e667b04042ae124b5a52ab1edf3c72a4365f8f661a90
|
| 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.1-cp312-cp312-win_amd64.whl
| Download URL | aria_engine-1.4.1-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
2a3361916cd7404109c7f15c5732ea5b0e58f1fa5659dc2f0c5f37f591f262fd
|
|
BLAKE2b-256 checksum How to use checksums |
9d8ac0b1a8be752f3edb9f7fbe25da783055a0ce41864ccd1a704b72c41c2b21
|
| 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.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.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 |
3739b83464bf0985c168d65a3dcbe52d7f3be051da13b474b093ab59475c78c4
|
|
BLAKE2b-256 checksum How to use checksums |
18e76bf34184941e051fe62fbc7fae5404b1fc59d6c410b86bf536e4cb566f78
|
| 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.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.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 |
cbcb96cd8e88704012654a8e963c22942094879c8202836e88077aa946950902
|
|
BLAKE2b-256 checksum How to use checksums |
d6ce26c3b5856b88b9f323402c933184f68fa7c534fb33330e2b919303a7fab0
|
| 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.1-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.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 |
df5b6c0ee4a98a5127bc26eef8ead5e76fc79d7ab55237a3348f363fbc5e77f5
|
|
BLAKE2b-256 checksum How to use checksums |
43a59a3200869f9e51625cac57c3703c9926e127534556d3cb9fb1932b65708e
|
| 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.1-cp311-cp311-win_amd64.whl
| Download URL | aria_engine-1.4.1-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
41813cee08599e70c2c0824cc04714be850604c949c8818b1086f83bb3d12b68
|
|
BLAKE2b-256 checksum How to use checksums |
5b22ef442760ab779574bd5f5881fc45d2948edae6779d6a84860b4525c73f88
|
| 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.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.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 |
1e8efa7dbd884c32ac55900483c2ba2e24a46a342218083ef924f9a072166695
|
|
BLAKE2b-256 checksum How to use checksums |
5e58b01294396cf882cb6f6f028d431862fc03ea174ca54a1f131ef4538ff1dc
|
| 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.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.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 |
c7648f18bc63009de2393d4771ed5b8bc6e7aba88e721f3f4499994773073621
|
|
BLAKE2b-256 checksum How to use checksums |
a8b378e71b44caa6d7b678defd357d873dd20dd076948faaf2cd1c4fc64cf801
|
| 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.1-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.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 |
8e68e88453d02830d911d39a0189f19e57d06814a698c7e19ab25221afbb7fdb
|
|
BLAKE2b-256 checksum How to use checksums |
1461696f00ebd0af54a5cb94db5ea954e41b262ea95093365919217bff19999e
|
| 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.1-cp310-cp310-win_amd64.whl
| Download URL | aria_engine-1.4.1-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
8cd9f1941ddf26fffeaae80b615eb199056803b22082fc1e081d9154cdfc54c7
|
|
BLAKE2b-256 checksum How to use checksums |
da529a30c3b68f822a92db92d9554f2e53220db45f6c8c0084da5708dba15a3e
|
| 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.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.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 |
beab72733f564fe35c5bad8679a973944230e7bd9c263c3ab4caa95dcb107990
|
|
BLAKE2b-256 checksum How to use checksums |
918f99e0efd89b9f6eee1253c9a181a93acf5020d1a3b5ed1983035e460a839c
|
| 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.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.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 |
ffec03b5b05f7ab54fea6b94c00193954a3d7b8e44b9a3ecd5bfa031cf3c8c24
|
|
BLAKE2b-256 checksum How to use checksums |
099ee1c6437dc87d66fa9763d986110a9a5a05c411ccd30eb7b8ccfefa50df46
|
| 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.1-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.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 |
994ad21bda775d6339d1dcc65cae441d71435958e729b3ad974ca3250147e7b9
|
|
BLAKE2b-256 checksum How to use checksums |
e54ccf3e5e9ade7ee59514f51f66d259b840c59f00abc2d739353a349da33810
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
