Configuration

Initializing

await RunAnywhere.initialize({ environment: 'development' })

interface InitializeOptions {
  apiKey?: string
  baseUrl?: string
  environment?: 'production' | 'development' // default 'production'
  appIdentifier?: string
  appName?: string
  appVersion?: string
}

Single-phase and async. There is no separate services phase to await, unlike Swift and Kotlin.

Reading state

Accessor	Type	Meaning
`RunAnywhere.isReady`	`boolean`	Local inference is usable
`RunAnywhere.version`	`string`	SDK version
`RunAnywhere.deviceId`	`string`	Stable per-browser identifier
`RunAnywhere.events`	`AsyncIterable<SdkEvent>`	Lifecycle and error breadcrumbs

Capabilities

const capabilities = await RunAnywhere.capabilities()

for (const missing of capabilities.unavailable) {
  console.log(missing.name, missing.reason)
}

Generated from live backend and runtime probes, never from namespace presence alone. An unavailable modality is reported honestly in unavailable rather than failing with a generic error the first time you use it. Read this before offering a feature in your interface.

Storage

The browser needs a persistence story the native SDKs do not have, and this namespace is it.

RunAnywhere.storage.backend // 'fsAccess' | 'opfs' | 'memory'
RunAnywhere.storage.directoryName // string | null, null on OPFS

await RunAnywhere.storage.chooseDirectory() // needs a user gesture
await RunAnywhere.storage.restore() // after a reload
await RunAnywhere.storage.requestAccess() // permission lapsed
await RunAnywhere.storage.refresh() // reconcile catalog against disk
await RunAnywhere.storage.clearCaches()

Backend	Meaning
`opfs`	Origin-private storage. The default. Invisible to the user.
`fsAccess`	A real directory the user granted. Survives clearing site data.
`memory`	No persistence. Everything re-downloads.

chooseDirectory() requires a user gesture. Calling it outside a click handler is rejected by the browser.

After a reload, a previously granted directory has to be re-acquired with restore(), and a lapsed permission needs requestAccess(). Neither happens automatically.

Models

// Synchronous on Web
const models = RunAnywhere.models.list()
const model = RunAnywhere.models.get('qwen3-0.6b')
const info = RunAnywhere.models.register(registration)

// Asynchronous
for await (const event of RunAnywhere.models.download('qwen3-0.6b')) {
  if (event.type === 'progress') bar.value = event.fraction ?? 0
}

const loaded = await RunAnywhere.models.load('qwen3-0.6b')
await RunAnywhere.models.unload('qwen3-0.6b')
await RunAnywhere.models.unloadAll()
await RunAnywhere.models.delete('qwen3-0.6b')
await RunAnywhere.models.unregister('qwen3-0.6b')

const state = await RunAnywhere.models.state()
await RunAnywhere.models.checkCompatibility(/* … */)

list, get, and register are synchronous on Web and async on every other SDK. Code ported from Swift or React Native will not need await here.

You rarely need load directly. Generation auto-loads what it needs and downloads when options.model names a model that is absent.

Hugging Face token

RunAnywhere.setHuggingFaceToken(token) // null to clear

Needed for gated or private repositories.

Events

for await (const event of RunAnywhere.events) {
  console.log(event)
}

Resetting

await RunAnywhere.reset()

Unloads models, closes sessions, and clears state.

Getting Started

Swift SDK

Kotlin SDK

React Native SDK

Flutter SDK

Web SDK

Electron SDK

Vibe Coding

Initializing

Reading state

Capabilities

Storage

Models

Hugging Face token

Events

Resetting

​Initializing

​Reading state

​Capabilities

​Storage

​Models

​Hugging Face token

​Events

​Resetting

Initializing

Reading state

Capabilities

Storage

Models

Hugging Face token

Events

Resetting