aria_engine (Flutter)

Flutter FFI binding for Aria Engine. Published to pub.dev under publisher ariacompute.com.

dependencies:
  aria_engine: ^0.1.0

import 'package:aria_engine/aria_engine.dart';

final eng = AriaEngine('/path/to/bundle');
print(eng.complete('[{"role":"user","content":"hi"}]'));
eng.dispose();

JNI/FFI must load libaria_ffi. AriaEngine.open installs it into ~/.ariacompute/lib/ when missing (ARIA_FFI_LIB / libPath still override).

Auto-download by model name

AriaEngine.open(modelRef, token: site: libPath:) accepts a local bundle path or an Aria model name (e.g. gemma-4-e2b-it_q4). A value containing / or already on disk is loaded directly; otherwise the SDK downloads it from the regional public hub (same as aria-engine download: .com → Hugging Face, .cn → ModelScope; site defaults to https://ariacompute.com) into ~/.ariacompute/models/{model} and then loads it. Dashboard is not used. A Dashboard sk- / bfvk- token is ignored for hub auth. Token is optional for public models. Gated files: pass hfToken / modelscopeApiToken (same as aria-engine setup); if omitted, reads ~/.ariacompute/engine.yml. Instance setup is in-memory only (does not write that file). A valid cached bundle is reused without re-downloading.

final eng = await AriaEngine.open("gemma-4-e2b-it_q4");
final gated = AriaEngine();
gated.setup(hfToken: "hf_...");
await gated.open("gemma-4-e2b-it_q4");

Published to pub.dev via publish-pub.yml. Secret PUB_CREDENTIALS is the JSON from dart pub login as a publisher member (browser Google account, e.g. the ariacompute.com publisher admin). The WSL/local OS user that owns the file, and the GitHub Actions identity, are not the pub.dev user. Device-farm: .github/workflows/bindings-mobile.yml.