Skip to main content

Expo AI Runtime

One AI API. On-device first, cloud when it counts.

A mobile-native AI runtime for Expo & React Native. It detects what each device can run, routes to the best provider, and tells you the privacy implications of every response.

Get startedGitHub
Default routing order
  1. apple-foundation-modelsApple Foundation ModelsiOS 26+ · Apple Intelligence
    on-device
  2. android-aicore-gemini-nanoGemini NanoAndroid · ML Kit GenAI / AICore
    on-device
device boundary
  1. apple-private-cloud-computePrivate Cloud ComputeApple-operated, stateless
    private cloud
  2. cloudCloud fallbackYour backend · opt-in
    third-party cloud
  3. noneUnavailableNo eligible provider
    n/a

Two lines to your first generation

The same call works across Apple Foundation Models, Android Gemini Nano and your cloud backend. Capability detection and fallback are handled for you.

import { ExpoAI } from "@stewmore/expo-ai-core";

const { text, provider, privacy } = await ExpoAI.generate({
  prompt: "Summarize this in one sentence.",
});

// text     -> the model output
// provider -> which engine answered (e.g. "apple-foundation-models")
// privacy  -> { isOnDevice, sendsPromptOffDevice, privacyMode }

The packages

A pure-TypeScript core plus thin native adapters. Import only what your app needs.

expo-ai-core

TypeScript
@stewmore/expo-ai-core

The pure-TS heart: the ExpoAI API, adapter contract, provider router, capability registry, sessions, structured output, privacy and normalized errors.

apple-foundation-models

iOS
@stewmore/expo-ai-apple-foundation-models

iOS adapter wrapping Apple’s on-device FoundationModels framework. Requires iOS 26+ with Apple Intelligence.

android-aicore

Android
@stewmore/expo-ai-android-aicore

Android adapter for Gemini Nano via ML Kit GenAI / AICore, including on-device model download.

cloud

TypeScript
@stewmore/expo-ai-cloud

Opt-in cloud fallback client adapter. POSTs to a configurable backend with streaming, for prompts that aren’t marked sensitive.

expo-ai-react

React
@stewmore/expo-ai-react

React hooks for the ExpoAI API.

evals

Node
@stewmore/expo-ai-evals

Node-first eval harness: provider comparison, schema validity, latency, fallback frequency and privacy-boundary checks.