Installation

Packages

npm install @runanywhere/core @runanywhere/llamacpp @runanywhere/onnx

@runanywhere/core is required. Add the backends you need.

Package	Version	Features
`@runanywhere/core`	`0.20.24`	SDK lifecycle, model registry, events, all capability APIs
`@runanywhere/llamacpp`	`0.20.24`	LLM and VLM inference on GGUF models
`@runanywhere/onnx`	`0.20.24`	STT, TTS, and VAD via ONNX Runtime and Sherpa-ONNX
`@runanywhere/mlx`	`0.20.24`	LLM, VLM, speech, and embeddings on Apple MLX
`@runanywhere/qhexrt`	`0.20.19`	Hexagon NPU inference on QNN-context models

@runanywhere/qhexrt is published at 0.20.19 and does not track the other four. Pin it separately rather than aligning the versions.

Optional backends

npm install @runanywhere/mlx      # iOS devices
npm install @runanywhere/qhexrt   # Android arm64 with a Hexagon NPU

@runanywhere/mlx registers only on physical iOS hardware: MLX.register() and MLX.isAvailable() both return false in the simulator. @runanywhere/qhexrt ships arm64-v8a only.

iOS

cd ios && pod install

Deployment target is 17.5 in every package podspec. For speech input, add to Info.plist:

<key>NSMicrophoneUsageDescription</key>
<string>Used for on-device speech recognition</string>

Android

minSdk 24, compileSdk and targetSdk 36.

AndroidManifest.xml

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />

Peer dependencies

Package	Version	Required	Purpose
`react-native`	`>=0.83.1`	Yes
`react`	`>=19.0.0`	Yes
`react-native-nitro-modules`	`^0.33.9`	Yes	The native module bridge the SDK is built on
`react-native-fs`	`>=2.20.0`	Optional	Clears oversize partial files when a download plan is rejected
`react-native-blob-util`	`>=0.19.0`	Optional
`react-native-device-info`	`>=11.0.0`	Optional

react-native-nitro-modules is a required peer dependency, not an optional one. Without it the JS side installs fine and the native module is missing at runtime, which reads as an SDK fault rather than a missing dependency.

npm install react-native-nitro-modules

Model downloads run through the SDK’s native download bridge, not through a JavaScript filesystem library. react-native-fs participates in one recovery path only: when a previous interrupted download left more bytes on disk than the new plan expects, the SDK deletes the oversize partials and re-plans once. Without it, that case surfaces as a deterministic error instead.

Registering a backend

import { RunAnywhere } from '@runanywhere/core'
import { LlamaCPP } from '@runanywhere/llamacpp'
import { ONNX } from '@runanywhere/onnx'

await LlamaCPP.register()
await ONNX.register()

await RunAnywhere.initialize({})

Devices, not emulators

The Android emulator has no arm64 native libraries for these backends, and MLX only executes on physical iOS hardware. Build to a device.

Getting Started

Swift SDK

Kotlin SDK

React Native SDK

Flutter SDK

Web SDK

Electron SDK

Vibe Coding

Packages

Optional backends

iOS

Android

Peer dependencies

Registering a backend

Devices, not emulators

​Packages

​Optional backends

​iOS

​Android

​Peer dependencies

​Registering a backend

​Devices, not emulators

Packages

Optional backends

iOS

Android

Peer dependencies

Registering a backend

Devices, not emulators