React Native ExecuTorch

// What it does

• Task hooks (`use<Task>`) for LLM chat, computer vision, speech and embeddings, with automatic model download, caching and lifecycle management
• A typed `models` registry over Software Mansion's Hugging Face collections of pre-exported models, plus support for your own `.pte` exports
• Hardware acceleration through XNNPACK (CPU), Core ML and MLX (Apple silicon) and Vulkan (Android GPU)
• A lower-level core with tensors, native operators, schema validation and worklet threading for building custom pipelines in TypeScript
• Model downloads go to a persistent cache keyed by URL, with progress reporting, cancellation and deduplication of concurrent downloads
• A `features` list in `package.json` limits which native backends and libraries are pulled in, to keep app size and install time down

// Getting started

React Native ExecuTorch needs the New Architecture, React Native 0.83+ or Expo SDK 55+ with a development build (Expo Go is not supported because of its custom C++ native libraries), `react-native-worklets` 0.10 or newer, and iOS 17.0+ or Android 13+ (minSdkVersion 26). The steps below follow the project's README and Getting Started guide.

npm install react-native-executorch react-native-worklets react-native-blob-util
# or
yarn add react-native-executorch react-native-worklets react-native-blob-util
# or
pnpm add react-native-executorch react-native-worklets react-native-blob-util

# Expo SDK 55/56
npm install react-native-worklets@^0.10.0

{
  "react-native-executorch": {
    "features": ["classification", "styleTransfer"]
  }
}

import { Button, View } from 'react-native';
import { models, useLLMChatSession } from 'react-native-executorch';

export function App() {
  const session = useLLMChatSession(models.llm.LFM2_5_1_2B.DEFAULT);

  const handleGenerate = async () => {
    if (!session.isReady || !session.sendMessage) return;

    const turn = await session.sendMessage(
      'Explain on-device AI in one sentence.',
      (token) => console.log(token)
    );

    console.log('Result messages:', turn.messages);
  };

  return (
    <View style={{ flex: 1, justifyContent: 'center', alignItems: 'center' }}>
      <Button
        title={session.isReady ? 'Generate' : `Loading (${session.downloadProgress.toFixed(0)}%)`}
        onPress={handleGenerate}
        disabled={!session.isReady}
      />
    </View>
  );
}

import { download, models } from 'react-native-executorch';

const model = await download(models.classification.EFFICIENTNET_V2_S.XNNPACK_FP32, {
  onProgress: (p) => console.log(`${Math.round(p * 100)}%`),
});

Commands and code are distilled from the project's own documentation — always check the official repo for the latest.

// When to use it

• Add a private, offline chat assistant to a React Native or Expo app without paying for or depending on a cloud LLM API
• Run camera-driven computer vision on the phone, such as object detection, segmentation or OCR on a photographed document
• Transcribe speech with Whisper or synthesise it with Kokoro on-device, so audio never leaves the user's phone
• Build local semantic search or RAG over on-device content using the library's image and text embedding models

// Version history

Every verified update to React Native ExecuTorch that AI/TLDR tracked, newest first — each links to our coverage and the official changeset.

1. 2026-09-25v0.10.3

   Patch release moving to the v0.10.4-libs native build, whose XNNPACK backend fixes PReLU models returning NaN and Kokoro TTS being killed on iPhone, plus LLM and install fixes. `LLMRunner.generate` no longer takes `echo`.

   changeset ↗
2. 2026-09-11v0.10.2

   Patch release fixing a build failure when opting out of a native library and an LLM error that was masked by its own rollback.

   changeset ↗
3. 2026-09-08v0.10.0

   A ground-up rewrite: task pipelines move into inspectable TypeScript over a lower-level native core, and Core ML, MLX and Vulkan acceleration join the XNNPACK CPU path across more than 130 pre-exported model variants, with a legacy module for gradual migration.

   changeset ↗

// How React Native ExecuTorch compares

React Native ExecuTorch alongside other open-source local runtimes tools AI/TLDR tracks, ranked by GitHub stars.