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.5.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.6 MB
Release files / aria_engine-1.5.1-cp313-cp313-win_amd64.whl
| Download URL | aria_engine-1.5.1-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
78318a47efaec9dabe145ebdf1b5460f8c6caca51d25eeec5bb196c3cc95d0e8
|
|
BLAKE2b-256 checksum How to use checksums |
631c5561b228e4f33ed5edcfdfb1860637730039a406d45d23821e0953e65234
|
| 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.5.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.5.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 |
4e3a61df3d003974075b5ddcaeb3444dc938ec5f64b19cb1e5b5f8d0b415f46c
|
|
BLAKE2b-256 checksum How to use checksums |
c3f3add51eb65753dd90ca1b1647d09fee2ab8029a1b7e2632ef3bb7e9bd5328
|
| 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.5.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.5.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 |
ed3d673d7f3a3d3625788fde286a2461dacf05979975923a5b8c999108d5f428
|
|
BLAKE2b-256 checksum How to use checksums |
1c451c31d9587b806a6b96412693d99bfe4c4a29ddf4f11f742dc7643d507078
|
| 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.5.1-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.5.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 |
f64e36009ce793fe8b2e54959e321925d018d5f04fef0af6a70027cd76461dc3
|
|
BLAKE2b-256 checksum How to use checksums |
bd6d955981399653b0bcaa62c58df2303e23b05aac4d4bf870106301939345a4
|
| 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.5.1-cp312-cp312-win_amd64.whl
| Download URL | aria_engine-1.5.1-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
84200d67f887a4e2562f039225af8358864c1a6cf771ea9e4703bb84a5fad279
|
|
BLAKE2b-256 checksum How to use checksums |
109751384f7783475a0d6c42c02a652bc7d70609df1e1d845796e38ba9dd3d8f
|
| 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.5.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.5.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 |
920a45ca185d9159324b3030459edc39f723c98cbf97802684389bf47189340a
|
|
BLAKE2b-256 checksum How to use checksums |
795511c4ec4e76297bb8ea1d319acfe070c98ebdcc99c9223336d852e0639daf
|
| 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.5.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.5.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 |
6aa9eb45b266e7d9a1fc99cf41ace89d5c13eb1170642259121eb9abba574ecf
|
|
BLAKE2b-256 checksum How to use checksums |
bcb16a229bef8eb3818cc3c6417112aa5a0a35ee60affaa3f99af25a3220203a
|
| 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.5.1-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.5.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 |
90d9f24300249f9f5309bfefcb124a497a7ba62f9cd44fc45d34a444a0f737b6
|
|
BLAKE2b-256 checksum How to use checksums |
f112cd08125fd2df3e823271cf364a6bcb5ab8fb2faec72c402957c74ad6da80
|
| 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.5.1-cp311-cp311-win_amd64.whl
| Download URL | aria_engine-1.5.1-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
699ef44e579110813188ed7c46334d2ea774f03d343466e80df5fef1f31cb0b8
|
|
BLAKE2b-256 checksum How to use checksums |
79619ceff4522f170877c198eb2df9dd0b8d7aaab9bc482327af81fadece525c
|
| 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.5.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.5.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 |
61de03031ea2f5d8e6e97ae0e40872e7ae36ca6baf26a92714ae78d816197fba
|
|
BLAKE2b-256 checksum How to use checksums |
660d7da3d634477e5deebd1ab5c34faa2d633d92ff24639fb0fa34898d1cc231
|
| 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.5.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.5.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 |
8c77f65c02655763f063804a0c717beb4ecbb1bc17d8aeda7f075491e446a995
|
|
BLAKE2b-256 checksum How to use checksums |
56a87adca66f1cb2588858f0ea30b6a8a891ecdea12cfd47e26e4f8111c8781d
|
| 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.5.1-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.5.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 |
f6a2a08e219621b8f413f6c8864d0c40842721b6cd70e62873a3e6ba0fc77a11
|
|
BLAKE2b-256 checksum How to use checksums |
01a0ae05ec7a4fb139990a79f19eb96b80155291def10dec68029638369dac62
|
| 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.5.1-cp310-cp310-win_amd64.whl
| Download URL | aria_engine-1.5.1-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
3fa1759a44126da735c3fc09d2318fbe60f18532ca71acb8ca2517975e09d8f0
|
|
BLAKE2b-256 checksum How to use checksums |
9f0cfad99ad16c8d3a9352bf786786b2040860610e88c72ede0acccbf1137e17
|
| 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.5.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.5.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 |
3231ac703186e459e9c15d717e59d48134dc811786c3a177fd617746d8d5c491
|
|
BLAKE2b-256 checksum How to use checksums |
72b19834fab2128b6f44d4d1dc17df850995a94f39b37384df1077256636b849
|
| 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.5.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.5.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 |
270732508a8ecaa67002007da609adb42656adec62535498f714e76aadb705aa
|
|
BLAKE2b-256 checksum How to use checksums |
2d984d5af086b06723be5a03a04512bf15be9e5bad2c500b2bac170bc65b0e29
|
| 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.5.1-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.5.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 |
1e9717e993013e352340468c4e6a62ba4c7c603ddcc2753cb7d8ff68c49ea73b
|
|
BLAKE2b-256 checksum How to use checksums |
9824fae4484a8f2b96dda4e381ff14b303147ed66f75d2257c64cc882a478d92
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
