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}))
按模型名自动下载
Engine 同时接受本地 bundle 路径或 Aria 模型名（如 gemma-4-e2b-it_q4）。含 /
或本地已存在的值直接加载；否则由 SDK 从 Dashboard 私有源 自动下载（需 token，
site 默认 https://ariacompute.com）到 ~/.ariacompute/models/{model} 再加载。
缓存中已有有效 bundle 时直接复用，不重复下载。
with Engine("gemma-4-e2b-it_q4", token="API_TOKEN") 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.7.0
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.7.0-cp313-cp313-win_amd64.whl
| Download URL | aria_engine-1.7.0-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
b9ff51be7c68e8b8eab2870fe9d6e9a7787eb4cf13d80470d75960c554c25643
|
|
BLAKE2b-256 checksum How to use checksums |
aef22ea6f79a70eb9148537c4cb3d32289321425f36a933f3b4af4947299b2a0
|
| 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.7.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.7.0-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 |
53328cf0a6ca8a0399eac8d15db134016f53d840a9f4ceddabf4600ed8272c62
|
|
BLAKE2b-256 checksum How to use checksums |
889aedb2016bc87c8226462446a1a5f411e0d284a76fcdf7d1f21b8ce52006bd
|
| 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.7.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.7.0-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 |
e2b5704ae5e11cd8da7eec1a25bea2a084ee3be50bda90a162bfc0e4dd7fb31a
|
|
BLAKE2b-256 checksum How to use checksums |
1e96ca8f707d04cfb9171a2dfe406833aad5130357932aed449060e2463d8485
|
| 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.7.0-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.7.0-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 |
f738397e167d821dc0bc8c252a9c2019247a4864d0745f72a107dd7ce7950853
|
|
BLAKE2b-256 checksum How to use checksums |
b3339672bb3abd0486ba0e5d5d1d86a471cae30e165671b41c4fba0956373d12
|
| 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.7.0-cp312-cp312-win_amd64.whl
| Download URL | aria_engine-1.7.0-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
8f4e6054d8108aefae43cf70cac319e3b24fe2c09c5d91b006cb9fcc9f3937ae
|
|
BLAKE2b-256 checksum How to use checksums |
d3221ee12f08c78c02f13d6c8b5ad0c0688308bf326db127b6f5bd7050a632f4
|
| 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.7.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.7.0-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 |
d0e4e537bed8e8acf9fe4d4b6d3ae2d01d4b00efe8e1e5cec6f372ab5695ca1e
|
|
BLAKE2b-256 checksum How to use checksums |
a07ff88b5dc2419f839804afd423e1da516fd7a174361b00c4d5e0b3dc4b91de
|
| 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.7.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.7.0-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 |
435c3e41090acc395b028edca5d1ad6d696d9f4013e4c1daf56aef104dcfbd14
|
|
BLAKE2b-256 checksum How to use checksums |
bbcfb2214bf82cf1b2c11ec3b74648f3fb652ed81274f3965a637577efa20953
|
| 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.7.0-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.7.0-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 |
5470f59a13e50b9f7d00beba127e78432b4d2a4b29961a45709620d9ffd19335
|
|
BLAKE2b-256 checksum How to use checksums |
37b9cf8de538d0a1edd412604c71023c1cc37f0bb0b14c2522e740a451b69fc9
|
| 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.7.0-cp311-cp311-win_amd64.whl
| Download URL | aria_engine-1.7.0-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
f84b87dc20909a1dd66a979990b4d3df0450cb3852c3622108975b5b103dd5eb
|
|
BLAKE2b-256 checksum How to use checksums |
34e87c0861112a5dbbbac06568fa5ecc5cfe80cd38b0489b46eaa099d715f091
|
| 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.7.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.7.0-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 |
c6a9dfcd593a4d2e8e28c505b00af4c117a066124d1b28f52c3f9b32f81e506e
|
|
BLAKE2b-256 checksum How to use checksums |
374a510279851a1a01ae7109e7f29d3825dee481f3d902554def1c8f5d572b26
|
| 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.7.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.7.0-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 |
1068f668936ff0ff9d77b56ae27df7ac63fd688befd6d71ad15dd26e863e7b52
|
|
BLAKE2b-256 checksum How to use checksums |
f7025a87113b3749addf757956a153daccb48662c2750a39731fd40988be6c92
|
| 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.7.0-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.7.0-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 |
fd0c320ae2877e79b8c80235829cf37aeb71e64a0a0b5a860e4db54f594b3563
|
|
BLAKE2b-256 checksum How to use checksums |
8c4f212f54357233d625f2cd12a7ef9b91eb10145b0c0a784575349211f18ec4
|
| 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.7.0-cp310-cp310-win_amd64.whl
| Download URL | aria_engine-1.7.0-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
ac7909c2328d1340a53b52e18f6aa5ace6b3f0fcdfa97c6b7d62a82d0d1cee98
|
|
BLAKE2b-256 checksum How to use checksums |
cdfffd6cf5289a875384dca058a1608fd68a0f97b8cf5570767dcd26ac077cdb
|
| 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.7.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | aria_engine-1.7.0-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 |
df27ae9c09c65a6bad89d3ef231922dabebee15416af7299ea47c44b61f250a4
|
|
BLAKE2b-256 checksum How to use checksums |
51d9a9f0cf0038f4be0c5685df2218b797b3a646fab4dfc8279e04b93aba5387
|
| 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.7.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | aria_engine-1.7.0-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 |
2fc3ab6ef7c7337d2c41ffa154cceb63e1810e28d9bc4b3cb38846b2dd6e8e99
|
|
BLAKE2b-256 checksum How to use checksums |
2f515c8def4180d38e4bde92252c0e2656c3a3fb97e796be0c4182e03e36410c
|
| 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.7.0-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | aria_engine-1.7.0-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 |
19bf6ebed82f9c7d0e845271ce8772a6c01bfc4144d2bef31773b0fd01bbf0fe
|
|
BLAKE2b-256 checksum How to use checksums |
1b8879bb3e876521261e5c740331b6fadf7e8f49e47573f57e64c987213cc770
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
