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.4
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.4-cp313-cp313-win_amd64.whl
| Download URL | aria_engine-1.4.4-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
cb93b42c6a1f739ce010cc2ce582269a59fb9f40bf4800042b96e443294fad5d
|
|
BLAKE2b-256 checksum How to use checksums |
3351b641002c1c0a3070b154ff807ac22902231e61dd4ab6f825397de7419fdb
|
| 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.4-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.4-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 |
8ceea243faf7d5fafcd81a60de717a44dab79d660b8076037d1a4fb0092b91c4
|
|
BLAKE2b-256 checksum How to use checksums |
d9ff741f2296bd1344a689ea33634ea726626d062fa5973570ac82e784cc0825
|
| 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.4-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.4-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 |
e9e5e7b00cfadf7bd33ed11e301625a41223bd7b260095faa75a98a7dc695ae6
|
|
BLAKE2b-256 checksum How to use checksums |
0495dd20915480ae13af0d0f6e44a0c3d2fcff6d8e1fb55445451f964f06b3f5
|
| 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.4-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.4-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 |
9b1ce4f591929b74a35624312d6c8f83e8055b65b7ec3db1cf82b0a20b16e53e
|
|
BLAKE2b-256 checksum How to use checksums |
4dbbca2bb96a1671b2624078f45ee525a0614825bf519e3e2defd43905fba5ca
|
| 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.4-cp312-cp312-win_amd64.whl
| Download URL | aria_engine-1.4.4-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
437b4188b596b101f3a1af09bd35b2afbdbd87a0cfe5b8ecb6b118639ee86b3e
|
|
BLAKE2b-256 checksum How to use checksums |
3bc8600f94e585dd0e745a4d1610519f48c17dc28b2aa3ad0a681cf8c4be6067
|
| 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.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.4-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 |
4009e8347c09bead78068047076226350a420177275959b4ac955b0b7bffdc16
|
|
BLAKE2b-256 checksum How to use checksums |
a8dfcdf0cc82c14619bdd33fca7181c28ef5177a857362e2ec431c92e176f40b
|
| 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.4-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.4-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 |
8c45d8d3ff4c60b78c1ead93a35ad391056a5e8eddcccd741a80a051c1513881
|
|
BLAKE2b-256 checksum How to use checksums |
6162b2195fb908ac4eac2d2dcfc499b9382c530cf73de5644b1ef4d5f5268168
|
| 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.4-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.4-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 |
f360040a909bc5a1bd9fa0af0b8c02059d43f31b8e7806428813d4cfad20d4ba
|
|
BLAKE2b-256 checksum How to use checksums |
913351794a3d28f596b117fe38cb04bc672f82dde67f27f713b75fc243807eff
|
| 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.4-cp311-cp311-win_amd64.whl
| Download URL | aria_engine-1.4.4-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
180d602b02dbd4bf268486782583468d595a36fbc48035345d9ee3773e9cd61a
|
|
BLAKE2b-256 checksum How to use checksums |
978271fde267b06fa8475111320788cdbab4b948ddd4b4d21f1b9e8827fe6709
|
| 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.4-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.4-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 |
0994b0897c214376570ad7ad656f5bb5f79476bbe0bd19e5e88b76346fa2df0f
|
|
BLAKE2b-256 checksum How to use checksums |
871011e9382acb0132ac6ba9e0382e9ee60dff8cc4802a20473d4e5837bc1e14
|
| 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.4-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.4-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 |
18ed00bb5d56c54e83ea5d309c5b044345a0f9f597cba767e908216991ef94b1
|
|
BLAKE2b-256 checksum How to use checksums |
fa397789df2e3a2dd3fcd0da5861e8a115cdeaa07dc865c374fc4f6d7133109c
|
| 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.4-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.4-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 |
717a09d7cf77ad84292657a3501acb7e4d90acfe52a7fcf48e6dc87c5b131741
|
|
BLAKE2b-256 checksum How to use checksums |
e5415b39f0654cd358464e409730879acff37829bdb9acb4c5c6bfc98f708f30
|
| 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.4-cp310-cp310-win_amd64.whl
| Download URL | aria_engine-1.4.4-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
9b7b63e8af66f4e779e2bb2b9b525232263293f898c664af5740fbeb253c537b
|
|
BLAKE2b-256 checksum How to use checksums |
badcef8bb52c9b73daea275be9d85c6cce1ad39be095904802b3c1af5fd5095f
|
| 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.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.4.4-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 |
cf477aab245bb6efd157c3e849b0e498d179a760401aae11c0129af147bf4a62
|
|
BLAKE2b-256 checksum How to use checksums |
689619fe6ea757eca6eebb01aa56226983e0142b913caf570329ba7df64469e0
|
| 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.4-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.4.4-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 |
8f70bff67adf87fbc37e413b1c86105d97447f27309c935a9750d747f5bcddf2
|
|
BLAKE2b-256 checksum How to use checksums |
f8fb1b4b15f00bde43d775d100ac7ed55003efaf7bee58680425b69d1bd8dbd9
|
| 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.4-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.4.4-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 |
60b163b3a3616df3f751d08f49d59772a1a064d56cef9846767dbc6e0927f8aa
|
|
BLAKE2b-256 checksum How to use checksums |
dd9d154aa4cf617b143b079720bce977e3faba9b431cebef90baf2ecfc4f5489
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
