<div align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://github.com/software-mansion/react-native-executorch/raw/main/docs/static/img/logo-vertical-dark.svg">
<img src="https://github.com/software-mansion/react-native-executorch/raw/main/docs/static/img/logo-vertical.svg" alt="React Native ExecuTorch Logo" width="260">
</picture>
</div>
<br />
<br />
<div align="center">
<a href="https://swm-delivery.com/www/delivery/ck-slug.php?zoneid=zone-gh-react-native-executorch-1&n=1"><img src="https://swm-delivery.com/www/images/zone-gh-react-native-executorch-1?n=1" /></a>
<a href="https://swm-delivery.com/www/delivery/ck-slug.php?zoneid=zone-gh-react-native-executorch-2&n=1"><img src="https://swm-delivery.com/www/images/zone-gh-react-native-executorch-2?n=1" /></a>
<a href="https://swm-delivery.com/www/delivery/ck-slug.php?zoneid=zone-gh-react-native-executorch-3&n=1"><img src="https://swm-delivery.com/www/images/zone-gh-react-native-executorch-3?n=1" /></a>
<a href="https://github.com/software-mansion/react-native-executorch/graphs/contributors"><img src="https://img.shields.io/github/contributors/software-mansion/react-native-executorch?style=for-the-badge&color=00008B" alt="GitHub - Contributors"></a>
<a href="https://github.com/software-mansion/react-native-executorch/stargazers"><img src="https://img.shields.io/github/stars/software-mansion/react-native-executorch?style=for-the-badge&color=00008B" alt="GitHub - Stars"></a>
<a href="https://discord.gg/ZGqqY55qkP"><img src="https://img.shields.io/badge/Discord-Join%20Us-00008B?logo=discord&logoColor=white&style=for-the-badge" alt="Join our Discord community"></a>
<a href="https://docs.swmansion.com/react-native-executorch/"><img src="https://img.shields.io/badge/Documentation-00008B?logo=googledocs&logoColor=white&style=for-the-badge" alt="Documentation"></a>
<a href="https://swmansion.com/contact">
<img src="https://img.shields.io/badge/Hire%20Us-00008B?logo=react&logoColor=white&color=darkgreen&style=for-the-badge" alt="Hire Us">
</a>
</div>
<br/>
**React Native ExecuTorch** is an on-device AI inference library for React Native, powered by [ExecuTorch](https://executorch.ai) — Meta's on-device inference runtime. It lets you run machine learning models directly on the user's phone with zero network calls, full offline capability, and guaranteed privacy. No data ever leaves the device.
The library ships with a curated set of pre-exported models covering computer vision, language models, text-to-speech, transcription, and more — all available in our [Hugging Face collection](https://huggingface.co/software-mansion/collections) and ready to use out of the box. You can also bring your own `.pte` models and plug them into existing pipelines or build entirely custom ones from scratch.
To export your own PyTorch models to `.pte`, use [ExecuTorch Export Recipes](https://github.com/software-mansion-labs/executorch-export-recipes), our export harness with model recipes and agent skills.
To explore all on-device capabilities in an interactive showcase app, check out the [React Native ExecuTorch Gallery](https://github.com/software-mansion-labs/react-native-executorch-gallery).
[](https://www.npmjs.com/package/react-native-executorch)
[](https://www.npmjs.com/package/react-native-executorch)
[](https://github.com/software-mansion/react-native-executorch/actions/workflows/ci.yml)
## Table of Contents
- [Key Features](#key-features)
- [Quickstart](#quickstart)
- [1. Installation](#1-installation)
- [2. Run the Model](#2-run-the-model)
- [Documentation](#documentation)
- [Powered by React Native ExecuTorch](#powered-by-react-native-executorch)
- [Created by Software Mansion](#created-by-software-mansion)
## Key Features
- **Native Hardware Acceleration**: Optimized execution delegates across backends: **XNNPACK** (CPU), **Core ML** & **MLX** (Apple Silicon), and **Vulkan** (Android GPU).
- **100% Offline & Private**: Zero cloud inference costs and zero network dependency after model download. No user data ever leaves the device.
- **Two-Layer Architecture**:
- **Ready-to-use Task Hooks (`use<Task>`)**: Out-of-the-box support for LLMs, computer vision, speech, and embeddings with automatic caching and lifecycle management.
- **Lower-level Runtime & Custom Orchestration**: Build custom pipelines entirely in TypeScript using low-level tensor operations, fast native operators, schema validation, and worklet threading.
- **Pre-Exported Model Catalog**: Access verified models directly via the `models` registry and the [Software Mansion Hugging Face Collections](https://huggingface.co/software-mansion/collections).
## Quickstart
> [!TIP]
> **Using an AI coding agent?** The consumer skill helps your agent choose ready-made models and task
> hooks, integrate a custom `.pte`, or build a custom TypeScript pipeline.
>
> Install the consumer skill from the Software Mansion skills repository:
>
> ```bash
> npx skills add software-mansion-labs/skills -s react-native-executorch
> ```
>
> See [AI Tools](https://docs.swmansion.com/react-native-executorch/docs/next/fundamentals/ai-tools)
> for model-selection guidance and an example prompt.
### 1. Installation
Install `react-native-executorch` alongside its required peer dependencies:
```bash
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
```
> [!IMPORTANT]
> React Native ExecuTorch requires:
> - **New Architecture** enabled
> - **React Native 0.83+** or **Expo SDK 55+** with [Development Builds](https://docs.expo.dev/develop/development-builds/introduction/) (**Expo Go is not supported** due to custom C++ native libraries)
> - **`react-native-worklets` 0.10 or newer** (`>=0.10.0 <0.14.0`)
> - **iOS 17.0+** / **Android 8.0+** (`minSdkVersion` >= 26)
> - **`react-native-worklets/plugin`** as the last entry in your Babel `plugins`
>
> Downloads of our pre-exported models send an anonymous download event; call `setTelemetryEnabled(false)` to opt out.
>
> See the [Getting Started Guide](https://docs.swmansion.com/react-native-executorch/docs/fundamentals/getting-started) and [Compatibility table](https://docs.swmansion.com/react-native-executorch/docs/other/compatibility) for more details.
### 2. Run the Model
```tsx
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>
);
}
```
## Documentation
**Building with an AI coding agent?** See [AI Tools](https://docs.swmansion.com/react-native-executorch/docs/next/fundamentals/ai-tools)
for model-selection guidance and an example prompt.
Choose a pre-exported model with a task hook, or bring your own `.pte` and build a custom TypeScript pipeline.
Full documentation, guides, architecture deep dives, and API references are available at:
**[docs.swmansion.com/react-native-executorch](https://docs.swmansion.com/react-native-executorch/)**
- [Getting Started Guide](https://docs.swmansion.com/react-native-executorch/docs/fundamentals/getting-started)
- [Downloading & Caching Models](https://docs.swmansion.com/react-native-executorch/docs/fundamentals/downloading-models)
- [Task Extensions & Pipelines](https://docs.swmansion.com/react-native-executorch/docs/category/extensions)
- [Core Primitives & Custom Pipelines](https://docs.swmansion.com/react-native-executorch/docs/category/core--advanced)
- [Exporting Custom `.pte` Models](https://docs.swmansion.com/react-native-executorch/docs/core-and-advanced/exporting-custom-models)
## Powered by React Native ExecuTorch
React Native ExecuTorch powers [Private Mind](https://privatemind.swmansion.com/), a privacy-first mobile AI application available on [App Store](https://apps.apple.com/gb/app/private-mind/id6746713439) and [Google Play](https://play.google.com/store/apps/details?id=com.swmansion.privatemind).
<img width="2620" height="985" alt="Private Mind promo" src="https://raw.githubusercontent.com/software-mansion-labs/private-mind/main/promo/promo.png" />
It also powers these libraries:
- [React Native RAG](https://github.com/software-mansion-labs/react-native-rag): private, on-device retrieval-augmented generation for your own documents.
- [React Native OCR](https://github.com/software-mansion-labs/react-native-ocr): on-device document OCR with page layout, tables, dewarping and vertical text.
## Created by Software Mansion
Since 2012, [Software Mansion](https://swmansion.com) has been building mobile and web apps, contributing to open-source software, and dealing with all kinds of React Native challenges. We are Core React Native Contributors. We can help you build your next AI product – [Hire us](https://swmansion.com/contact?utm_source=react-native-executorch&utm_medium=readme).
[](https://swmansion.com)