react-native-executorch 0.4.10 → 0.5.0-nightly-6f4dd53-20251211

package/README.md

@@ -1,55 +1,79 @@
-<div align="right">
-  <h1 align="left" style="display:inline-block">React Native ExecuTorch <a href="https://www.producthunt.com/posts/react-native-executorch?embed=true&utm_source=badge-featured&utm_medium=badge&utm_souce=badge-react&#0045;native&#0045;executorch" target="_blank" rel="noopener noreferrer"><img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=891872&theme=neutral&t=1742503583297" alt="React Native ExecuTorch - Product Hunt" height="34" align="right" /></a></h1>
+<div align="center">
+  <h1 align="center" style="display:inline-block">React Native ExecuTorch 
+  </h1>
+</div>
+
+<div align="center">
+  <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>
 </div>
 
 ![Software Mansion banner](https://github.com/user-attachments/assets/fa2c4735-e75c-4cc1-970d-88905d95e3a4)
 
-**React Native ExecuTorch** is a declarative way to run AI models in React Native on device, powered by **ExecuTorch** 🚀.
+<p align="center">
+  <a href="https://github.com/software-mansion/react-native-executorch/blob/main/README.md">English</a>
+  <a href="https://github.com/software-mansion/react-native-executorch/blob/main/readmes/README_es.md">Español</a>
+  <a href="https://github.com/software-mansion/react-native-executorch/blob/main/readmes/README_fr.md">Français</a>
+  <a href="https://github.com/software-mansion/react-native-executorch/blob/main/readmes/README_cn.md">简体中文</a>
+  <a href="https://github.com/software-mansion/react-native-executorch/blob/main/readmes/README_pt.md">Português</a>
+  <a href="https://github.com/software-mansion/react-native-executorch/blob/main/readmes/README_in.md">हिंदी</a>
+</p>
 
-**ExecuTorch** is a novel framework created by Meta that enables running AI models on devices such as mobile phones or microcontrollers. React Native ExecuTorch bridges the gap between React Native and native platform capabilities, allowing developers to run AI models locally on mobile devices with state-of-the-art performance, without requiring deep knowledge of native code or machine learning internals.
+**React Native ExecuTorch** provides a declarative way to run AI models on-device using React Native, powered by **ExecuTorch** :rocket:. It offers out-of-the-box support for a wide range of LLMs, computer vision models, and more. Visit our [HuggingFace](https://huggingface.co/software-mansion) page to explore these models.
 
-**Table of contents:**
+**ExecuTorch**, developed by Meta, is a novel framework allowing AI model execution on devices like mobile phones or microcontrollers.
 
-- [Compatibility](#compatibility)
-- [Ready-made models 🤖](#readymade-models-)
-- [Documentation 📚](#documentation-)
-- [🦙 Quickstart - Running Llama](#-quickstart---running-llama)
-- [Minimal supported versions](#minimal-supported-versions)
-- [Examples 📲](#examples-)
-- [Warning](#warning)
-- [License](#license)
-- [What's next?](#whats-next)
+React Native ExecuTorch bridges the gap between React Native and native platform capabilities, enabling developers to efficiently run local AI models on mobile devices. This can be achieved without the need for extensive expertise in native programming or machine learning.
 
-## Compatibility
+[![npm version](https://img.shields.io/npm/v/react-native-executorch?color=00008B)](https://www.npmjs.com/package/react-native-executorch)
+[![CI](https://github.com/software-mansion/react-native-executorch/actions/workflows/ci.yml/badge.svg)](https://github.com/software-mansion/react-native-executorch/actions/workflows/ci.yml)
 
-React Native Executorch supports only the [New React Native architecture](https://reactnative.dev/architecture/landing-page).
+<details>
+<summary><strong> :blue_book: Table of Contents </strong></summary>
 
-If your app still runs on the old architecture, please consider upgrading to the New Architecture.
+- [:yin_yang: Supported Versions](#yin_yang-supported-versions)
+- [:earth_africa: Real-world Example](#earth_africa-real-world-example)
+- [:llama: Quickstart - Running Llama](#llama-quickstart---running-llama)
+- [:calling: Demo Apps](#calling-demo-apps)
+- [:robot: Ready-made Models](#robot-ready-made-models)
+- [:books: Documentation](#books-documentation)
+- [:balance_scale: License](#balance_scale-license)
+- [:soon: What's Next?](#soon-whats-next)
 
-## Ready-made models 🤖
+</details>
 
-To run any AI model in ExecuTorch, you need to export it to a `.pte` format. If you're interested in experimenting with your own models, we highly encourage you to check out the [Python API](https://pypi.org/project/executorch/). If you prefer focusing on developing your React Native app, we will cover several common use cases. For more details, please refer to the documentation.
+## :yin_yang: Supported Versions
 
-## Documentation 📚
+The minimal supported version are: 
+* iOS 17.0
+* Android 13
+* React Native 0.76
 
-Take a look at how our library can help build you your React Native AI features in our docs:  
-https://docs.swmansion.com/react-native-executorch
+> [!IMPORTANT]  
+> React Native ExecuTorch supports only the [New React Native architecture](https://reactnative.dev/architecture/landing-page).
+
+## :earth_africa: Real-world Example
+
+React Native ExecuTorch is powering [Private Mind](https://privatemind.swmansion.com/), a privacy-first mobile AI app 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).
 
-# 🦙 **Quickstart - Running Llama**
+<img width="2720" height="1085" alt="Private Mind promo" src="https://github.com/user-attachments/assets/b12296fe-19ac-48fc-9726-da9242700346" />
+
+## :llama: **Quickstart - Running Llama**
 
 **Get started with AI-powered text generation in 3 easy steps!**
 
-### 1️⃣ **Installation**
+### :one: **Installation**
 
 ```bash
 # Install the package
 yarn add react-native-executorch
-cd ios && pod install && cd ..
+# Depending on the platform, choose either iOS or Android
+yarn expo run:< ios | android >
 ```
 
----
-
-### 2️⃣ **Setup & Initialization**
+### :two: **Setup & Initialization**
 
 Add this to your component file:
 
@@ -57,28 +81,22 @@ Add this to your component file:
 import {
   useLLM,
   LLAMA3_2_1B,
-  LLAMA3_2_TOKENIZER_CONFIG,
+  Message
 } from 'react-native-executorch';
 
 function MyComponent() {
   // Initialize the model 🚀
-  const llama = useLLM({
-    modelSource: LLAMA3_2_1B,
-    tokenizerSource: LLAMA3_2_TOKENIZER,
-    tokenizerConfigSource: LLAMA3_2_TOKENIZER_CONFIG,
-  });
+  const llm = useLLM({ model: LLAMA3_2_1B });
   // ... rest of your component
 }
 ```
 
----
-
-### 3️⃣ **Run the model!**
+### :three: **Run the Model!**
 
 ```tsx
 const handleGenerate = async () => {
-  const chat = [
-    { role: 'system' content: 'You are a helpful assistant' }
+  const chat: Message[] = [
+    { role: 'system', content: 'You are a helpful assistant' },
     { role: 'user', content: 'What is the meaning of life?' }
   ];
 
@@ -88,61 +106,49 @@ const handleGenerate = async () => {
 };
 ```
 
-## Minimal supported versions
-
-The minimal supported version is 17.0 for iOS and Android 13.
+## :calling: Demo Apps
 
-## Examples 📲
+We currently host a few example [apps](https://github.com/software-mansion/react-native-executorch/tree/main/apps) demonstrating use cases of our library:
 
-https://github.com/user-attachments/assets/27ab3406-c7f1-4618-a981-6c86b53547ee
+- `llm` - Chat application showcasing use of LLMs
+- `speech-to-text` - Whisper model ready for transcription tasks
+- `computer-vision` - Computer vision related tasks
+- `text-embeddings` - Computing text representations for semantic search
 
-We currently host a few example apps demonstrating use cases of our library:
-
-- examples/llm - chat application showcasing use of LLMs
-- examples/speech-to-text - Whisper and Moonshine models ready for transcription tasks
-- examples/computer-vision - computer vision related tasks
-- examples/text-embeddings - computing text representations for semantic search
-
-If you would like to run it, navigate to it's project directory, for example `examples/llm` from the repository root and install dependencies with:
+If you would like to run demo app, navigate to its project directory and install dependencies with:
 
 ```bash
 yarn
 ```
 
-then run:
+Then, depending on the platform, choose either iOS or Android:
 
 ```bash
-cd ios
-pod install
-cd ..
+yarn expo run:< ios | android >
 ```
 
-And finally, if you want to run on Android:
-
-```bash
-yarn expo run:android
-```
+> [!WARNING]  
+> Running LLMs requires a significant amount of RAM. If you are encountering unexpected app crashes, try to increase the amount of RAM allocated to the emulator.
 
-or iOS:
+## :robot: Ready-made Models
 
-```bash
-yarn expo run:ios
-```
+Our library has a number of ready-to-use AI models; a complete list is available in the documentation. If you're interested in running your own AI model, you need to first export it to the `.pte` format. Instructions on how to do this are available in the [Python API](https://docs.pytorch.org/executorch/stable/using-executorch-export.html) and [optimum-executorch README](https://github.com/huggingface/optimum-executorch?tab=readme-ov-file#option-2-export-and-load-separately).
 
-### Warning
+## :books: Documentation
 
-Running LLMs requires a significant amount of RAM. If you are encountering unexpected app crashes, try to increase the amount of RAM allocated to the emulator.
+Check out how our library can help you build your React Native AI features by visiting our docs:  
+https://docs.swmansion.com/react-native-executorch
 
-## License
+## :balance_scale: License
 
 This library is licensed under [The MIT License](./LICENSE).
 
-## What's next?
+## :soon: What's Next?
 
-To learn about our upcoming plans and developments, please visit our [discussion page](https://github.com/software-mansion/react-native-executorch/discussions/2).
+To learn about our upcoming plans and developments, please visit our [milestones](https://github.com/software-mansion/react-native-executorch/milestones).
 
 ## React Native ExecuTorch is created by Software Mansion
 
-Since 2012 [Software Mansion](https://swmansion.com) is a software agency with experience in building web and mobile apps. We are Core React Native Contributors and experts in dealing with all kinds of React Native issues. We can help you build your next dream product – [Hire us](https://swmansion.com/contact/projects?utm_source=react-native-executorch&utm_medium=readme).
+Since 2012, [Software Mansion](https://swmansion.com) is a software agency with experience in building web and mobile apps. We are Core React Native Contributors and experts in dealing with all kinds of React Native issues. We can help you build your next dream product – [Hire us](https://swmansion.com/contact/projects?utm_source=react-native-executorch&utm_medium=readme).
 
 [![swm](https://logo.swmansion.com/logo?color=white&variant=desktop&width=150&tag=react-native-executorch-github 'Software Mansion')](https://swmansion.com)

package/android/CMakeLists.txt

@@ -0,0 +1,29 @@
+cmake_minimum_required(VERSION 3.13)
+project(RnExecutorch)
+
+set (CMAKE_VERBOSE_MAKEFILE ON)
+set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
+set (CMAKE_CXX_STANDARD 20)
+
+include("${REACT_NATIVE_DIR}/ReactAndroid/cmake-utils/folly-flags.cmake")
+add_compile_options(${folly_FLAGS})
+
+
+if(ReactAndroid_VERSION_MINOR GREATER_EQUAL 80)
+  include("${REACT_NATIVE_DIR}/ReactCommon/cmake-utils/react-native-flags.cmake")
+  target_compile_reactnative_options(react-native-executorch PRIVATE)
+else()
+  string(APPEND CMAKE_CXX_FLAGS " -O2 -fstack-protector-all -fexceptions -frtti -std=c++${CMAKE_CXX_STANDARD} -Wall")
+endif()
+
+string(APPEND CMAKE_CXX_FLAGS " -DRCT_NEW_ARCH_ENABLED")
+
+set(ANDROID_CPP_DIR "${CMAKE_SOURCE_DIR}/src/main/cpp")
+set(COMMON_CPP_DIR "${CMAKE_SOURCE_DIR}/../common")
+set(LIBS_DIR "${CMAKE_SOURCE_DIR}/../third-party/android/libs")
+set(INCLUDE_DIR "${CMAKE_SOURCE_DIR}/../third-party/include")
+
+# Treat third-party headers as system headers to suppress deprecation warnings
+include_directories(SYSTEM "${INCLUDE_DIR}")
+
+add_subdirectory("${ANDROID_CPP_DIR}")

package/android/build.gradle

@@ -1,3 +1,5 @@
+import org.apache.tools.ant.taskdefs.condition.Os
+
 buildscript {
   ext {
     agp_version = '8.4.2'
@@ -21,19 +23,20 @@ buildscript {
 
 def reactNativeArchitectures() {
   def value = rootProject.getProperties().get("reactNativeArchitectures")
-  return value ? value.split(",") : ["armeabi-v7a", "x86", "x86_64", "arm64-v8a"]
-}
-
-def isNewArchitectureEnabled() {
-  return rootProject.hasProperty("newArchEnabled") && rootProject.getProperty("newArchEnabled") == "true"
+  // react-native-executorch supports only these architectures. This is due to
+  // Executorch not supporting anything else.
+  def defaultArchitectures = ["x86_64", "arm64-v8a"]
+  if(!value) {
+    return defaultArchitectures
+  }
+  def architectures = value.split(",")
+  return architectures.findAll { it in defaultArchitectures }
 }
 
 apply plugin: "com.android.library"
 apply plugin: "kotlin-android"
+apply plugin: "com.facebook.react"
 
-if (isNewArchitectureEnabled()) {
-  apply plugin: "com.facebook.react"
-}
 
 def getExtOrDefault(name) {
   return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties["RnExecutorch_" + name]
@@ -52,6 +55,38 @@ def supportsNamespace() {
   return (major == 7 && minor >= 3) || major >= 8
 }
 
+def safeAppExtGet(prop, fallback) {
+  def appProject = rootProject.allprojects.find { it.plugins.hasPlugin('com.android.application') }
+  appProject?.ext?.has(prop) ? appProject.ext.get(prop) : fallback
+}
+
+def toPlatformFileString(String path) {
+  if (Os.isFamily(Os.FAMILY_WINDOWS)) {
+      path = path.replace(File.separatorChar, '/' as char)
+  }
+  return path
+}
+
+def resolveReactNativeDirectory() {
+  def reactNativeLocation = safeAppExtGet("REACT_NATIVE_NODE_MODULES_DIR", null)
+
+  if (reactNativeLocation !== null) {
+    return file(reactNativeLocation)
+  }
+
+  // Fallback to node resolver for custom directory structures like monorepos.
+  def reactNativePackage = file(["node", "--print", "require.resolve('react-native/package.json')"].execute(null, rootDir).text.trim())
+  if(reactNativePackage.exists()) {
+      return reactNativePackage.parentFile
+  }
+
+  throw new GradleException(
+      "[RnExecutorch] Unable to resolve react-native location in node_modules. You should project extension property (in `app/build.gradle`) `REACT_NATIVE_NODE_MODULES_DIR` with path to react-native."
+  )
+}
+
+def reactNativeRootDir = resolveReactNativeDirectory()
+
 android {
   if (supportsNamespace()) {
     namespace "com.swmansion.rnexecutorch"
@@ -63,12 +98,40 @@ android {
     }
   }
 
+  buildFeatures {
+    prefab true
+    prefabPublishing true
+    buildConfig true
+  }
+
+  prefab {
+    "react-native-executorch" {
+      headers "src/main/cpp"
+    }
+  }
+
   compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
 
   defaultConfig {
     minSdkVersion getExtOrIntegerDefault("minSdkVersion")
     targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
-    buildConfigField("boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchitectureEnabled().toString())
+    externalNativeBuild {
+        cmake {
+          abiFilters (*reactNativeArchitectures())
+          arguments "-DANDROID_STL=c++_shared",
+                    "-DREACT_NATIVE_DIR=${toPlatformFileString(reactNativeRootDir.path)}",
+                    "-DBUILD_DIR=${project.buildDir}",
+                    "-DANDROID_TOOLCHAIN=clang",
+                    "-DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON"
+      }
+    }
+  }
+
+
+  externalNativeBuild {
+    cmake {
+      path "CMakeLists.txt"
+    }
   }
 
   buildTypes {
@@ -85,6 +148,7 @@ android {
     sourceCompatibility JavaVersion.VERSION_1_8
     targetCompatibility JavaVersion.VERSION_1_8
   }
+
 }
 
 repositories {
@@ -99,11 +163,10 @@ dependencies {
   // For < 0.71, this will be from the local maven repo
   // For > 0.71, this will be replaced by `com.facebook.react:react-android:$version` by react gradle plugin
   //noinspection GradleDynamicVersion
-  implementation 'com.github.wendykierp:JTransforms:3.1'
   implementation "com.facebook.react:react-android:+"
-  implementation 'org.opencv:opencv:4.10.0'
+  implementation "com.facebook.react:react-native:+"
+  implementation 'com.facebook.fbjni:fbjni:0.6.0'
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
-	implementation("com.github.software-mansion-labs:react-native-executorch:v0.4.10")
-  implementation 'org.opencv:opencv:4.10.0'
+  implementation files('libs/classes.jar')
   implementation("com.squareup.okhttp3:okhttp:4.9.2")
 }

package/android/src/main/cpp/CMakeLists.txt

@@ -0,0 +1,109 @@
+cmake_minimum_required(VERSION 3.13)
+
+file(GLOB_RECURSE ANDROID_CPP_SOURCES CONFIGURE_DEPENDS "${ANDROID_CPP_DIR}/*.cpp")
+file(GLOB_RECURSE COMMON_CPP_SOURCES CONFIGURE_DEPENDS "${COMMON_CPP_DIR}/*.cpp")
+file(GLOB_RECURSE COMMON_C_SOURCES CONFIGURE_DEPENDS "${COMMON_CPP_DIR}/*.c")
+file(GLOB_RECURSE TEST_CPP_SOURCES "${COMMON_CPP_DIR}/rnexecutorch/tests/*.cpp")
+list(REMOVE_ITEM COMMON_CPP_SOURCES ${TEST_CPP_SOURCES})
+
+add_library(react-native-executorch SHARED ${ANDROID_CPP_SOURCES} ${COMMON_CPP_SOURCES} ${COMMON_C_SOURCES})
+
+find_package(ReactAndroid REQUIRED CONFIG)
+find_package(fbjni REQUIRED CONFIG)
+
+target_include_directories(
+  react-native-executorch
+  PUBLIC
+  "${COMMON_CPP_DIR}"
+  "${ANDROID_CPP_DIR}"
+  "${INCLUDE_DIR}"
+  "${REACT_NATIVE_DIR}/ReactCommon"
+  "${REACT_NATIVE_DIR}/ReactAndroid/src/main/jni/react/turbomodule"
+  "${REACT_NATIVE_DIR}/ReactCommon/callinvoker"
+)
+
+set(LINK_LIBRARIES
+  ReactAndroid::jsi
+  fbjni::fbjni
+  android
+  log
+)
+
+set(RN_VERSION_LINK_LIBRARIES
+  ReactAndroid::reactnative
+)
+
+# Dependencies:
+
+# ------- Executorch -------
+
+add_library(executorch SHARED IMPORTED)
+
+set_target_properties(executorch PROPERTIES
+                      IMPORTED_LOCATION "${LIBS_DIR}/executorch/${ANDROID_ABI}/libexecutorch.so")
+
+
+if(ANDROID_ABI STREQUAL "arm64-v8a")
+  target_compile_definitions(react-native-executorch PRIVATE ARCH_ARM64)
+
+  # ------- pthreadpool -------
+  add_library(pthreadpool SHARED IMPORTED)
+
+  set_target_properties(pthreadpool PROPERTIES
+                        IMPORTED_LOCATION "${LIBS_DIR}/pthreadpool/${ANDROID_ABI}/libpthreadpool.so")
+
+  # ------- cpuinfo -------
+  add_library(cpuinfo SHARED IMPORTED)
+
+  set_target_properties(cpuinfo PROPERTIES
+                        IMPORTED_LOCATION "${LIBS_DIR}/cpuinfo/${ANDROID_ABI}/libcpuinfo.so")
+  set(EXECUTORCH_LIBS
+    "pthreadpool"
+    "cpuinfo"
+  )
+endif()
+
+# ------- OpenCV -------
+
+set(OPENCV_LIBS
+  "${LIBS_DIR}/opencv/${ANDROID_ABI}/libopencv_core.a"
+  "${LIBS_DIR}/opencv/${ANDROID_ABI}/libopencv_features2d.a"
+  "${LIBS_DIR}/opencv/${ANDROID_ABI}/libopencv_highgui.a"
+  "${LIBS_DIR}/opencv/${ANDROID_ABI}/libopencv_imgproc.a"
+  "${LIBS_DIR}/opencv/${ANDROID_ABI}/libopencv_photo.a"
+  "${LIBS_DIR}/opencv/${ANDROID_ABI}/libopencv_video.a"
+)
+
+if(ANDROID_ABI STREQUAL "arm64-v8a")
+  set(OPENCV_THIRD_PARTY_LIBS
+    "${LIBS_DIR}/opencv-third-party/${ANDROID_ABI}/libkleidicv_hal.a"
+    "${LIBS_DIR}/opencv-third-party/${ANDROID_ABI}/libkleidicv_thread.a"
+    "${LIBS_DIR}/opencv-third-party/${ANDROID_ABI}/libkleidicv.a"
+  )
+elseif(ANDROID_ABI STREQUAL "x86_64")
+  set(OPENCV_THIRD_PARTY_LIBS "")
+endif()
+
+# ------- tokenizers-cpp -------
+
+set(TOKENIZERS_LIBS
+  "${LIBS_DIR}/tokenizers-cpp/${ANDROID_ABI}/libtokenizers_c.a"
+  "${LIBS_DIR}/tokenizers-cpp/${ANDROID_ABI}/libtokenizers_cpp.a"
+  "${LIBS_DIR}/tokenizers-cpp/${ANDROID_ABI}/libsentencepiece.a"
+)
+# --------------
+
+target_link_options(react-native-executorch PRIVATE -fopenmp -static-openmp)
+
+target_link_libraries(
+  react-native-executorch
+  ${LINK_LIBRARIES}
+  ${RN_VERSION_LINK_LIBRARIES}
+  ${OPENCV_LIBS}
+  ${OPENCV_THIRD_PARTY_LIBS}
+  ${TOKENIZERS_LIBS}
+  ${TOKENIZERS_THIRD_PARTY_LIBS}
+  executorch
+  ${EXECUTORCH_LIBS}
+  z
+)

package/android/src/main/cpp/ETInstallerModule.cpp

@@ -0,0 +1,76 @@
+#include "ETInstallerModule.h"
+
+#include <rnexecutorch/RnExecutorchInstaller.h>
+
+#include <jni.h>
+#include <jsi/jsi.h>
+
+namespace rnexecutorch {
+JavaVM *java_machine;
+using namespace facebook::jni;
+
+ETInstallerModule::ETInstallerModule(
+    jni::alias_ref<ETInstallerModule::jhybridobject> &jThis,
+    jsi::Runtime *jsiRuntime,
+    const std::shared_ptr<facebook::react::CallInvoker> &jsCallInvoker)
+    : javaPart_(make_global(jThis)), jsiRuntime_(jsiRuntime),
+      jsCallInvoker_(jsCallInvoker) {}
+
+jni::local_ref<ETInstallerModule::jhybriddata> ETInstallerModule::initHybrid(
+    jni::alias_ref<jhybridobject> jThis, jlong jsContext,
+    jni::alias_ref<facebook::react::CallInvokerHolder::javaobject>
+        jsCallInvokerHolder) {
+  auto jsCallInvoker = jsCallInvokerHolder->cthis()->getCallInvoker();
+  auto rnRuntime = reinterpret_cast<jsi::Runtime *>(jsContext);
+  return makeCxxInstance(jThis, rnRuntime, jsCallInvoker);
+}
+
+void ETInstallerModule::registerNatives() {
+  registerHybrid({
+      makeNativeMethod("initHybrid", ETInstallerModule::initHybrid),
+      makeNativeMethod("injectJSIBindings",
+                       ETInstallerModule::injectJSIBindings),
+  });
+}
+
+void ETInstallerModule::injectJSIBindings() {
+  // Grab a function for fetching images via URL from Java
+  auto fetchDataByUrl = [](std::string url) {
+    // Attaching Current Thread to JVM
+
+    JNIEnv *env = nullptr;
+    int getEnvStat = java_machine->GetEnv((void **)&env, JNI_VERSION_1_6);
+    if (getEnvStat == JNI_EDETACHED) {
+      if (java_machine->AttachCurrentThread(&env, nullptr) != 0) {
+        throw std::runtime_error("Failed to attach thread to JVM");
+      }
+    }
+    static jclass cls = javaClassStatic().get();
+    static jmethodID method = env->GetStaticMethodID(
+        cls, "fetchByteDataFromUrl", "(Ljava/lang/String;)[B");
+
+    jstring jUrl = env->NewStringUTF(url.c_str());
+    jbyteArray byteData =
+        (jbyteArray)env->CallStaticObjectMethod(cls, method, jUrl);
+
+    if (env->IsSameObject(byteData, NULL)) {
+      throw std::runtime_error("Error fetching data from a url");
+    }
+
+    int size = env->GetArrayLength(byteData);
+    jbyte *bytes = env->GetByteArrayElements(byteData, JNI_FALSE);
+    std::byte *dataBytePtr = reinterpret_cast<std::byte *>(bytes);
+
+    return std::vector<std::byte>(dataBytePtr, dataBytePtr + size);
+  };
+
+  RnExecutorchInstaller::injectJSIBindings(jsiRuntime_, jsCallInvoker_,
+                                           fetchDataByUrl);
+}
+} // namespace rnexecutorch
+
+JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM *vm, void *) {
+  rnexecutorch::java_machine = vm;
+  return facebook::jni::initialize(
+      vm, [] { rnexecutorch::ETInstallerModule::registerNatives(); });
+}

package/android/src/main/cpp/ETInstallerModule.h

@@ -0,0 +1,43 @@
+#pragma once
+
+#include <ReactCommon/CallInvokerHolder.h>
+#include <fbjni/fbjni.h>
+#include <react/jni/CxxModuleWrapper.h>
+#include <react/jni/JMessageQueueThread.h>
+
+#include <memory>
+#include <utility>
+
+namespace rnexecutorch {
+
+using namespace facebook;
+using namespace react;
+
+class ETInstallerModule : public jni::HybridClass<ETInstallerModule> {
+public:
+  static auto constexpr kJavaDescriptor =
+      "Lcom/swmansion/rnexecutorch/ETInstaller;";
+
+  static jni::local_ref<ETInstallerModule::jhybriddata>
+  initHybrid(jni::alias_ref<jhybridobject> jThis, jlong jsContext,
+             jni::alias_ref<facebook::react::CallInvokerHolder::javaobject>
+                 jsCallInvokerHolder);
+
+  static void registerNatives();
+
+  void injectJSIBindings();
+
+private:
+  friend HybridBase;
+
+  jni::global_ref<ETInstallerModule::javaobject> javaPart_;
+  jsi::Runtime *jsiRuntime_;
+  std::shared_ptr<facebook::react::CallInvoker> jsCallInvoker_;
+
+  explicit ETInstallerModule(
+      jni::alias_ref<ETInstallerModule::jhybridobject> &jThis,
+      jsi::Runtime *jsiRuntime,
+      const std::shared_ptr<facebook::react::CallInvoker> &jsCallInvoker);
+};
+
+} // namespace rnexecutorch