Releases: software-mansion/react-native-executorch
Releases · software-mansion/react-native-executorch
v0.9.0
React Native ExecuTorch v0.9.0 🔒 🚀
This release, as always, brings a lot of fresh goodies to the React Native world ⚛️. It introduces new things across the stack, whether that's speech, vision, or NLP, check it out 👇🏻
What's new?
Speech
- Up to 10x performance improvements for transcription - We introduced a way to integrate VAD into Whisper transcription pipeline, along with underlying algorithm optimizations & NPU model exports, resulting in significantly improved performance docs
- Multilingual Text-to-Speech - We introduced a lot of new languages to the TTS API, including 🇵🇱 🇪🇸 🇮🇹 🇫🇷 🇮🇳 docs
- Text-to-Speech improvements - We improved the phonemization mechanisms to significantly enhance the pronunciation quality for existing languages
- VAD streaming API - You can now run voice activity detection in continuous, stream fashion docs
NLP
- OpenAI's Privacy Filter - A new
usePrivacyFilterAPI, making it easy to detect private user information from text, fully locally docs - Multilingual text embeddings - It is now possible to generate embeddings across different languages docs
- Qwen 3.5 support - Another LLM in our collection docs
- LFM2.5-VL-450M (quantized) & LFM2.5 350M - New multimodal and text-only LLMs from Liquid AI added to the registry
docs - Smarter LLM sampling -
min_pandrepetition_penaltysampling, per-model defaults, and letterboxed multimodal image preprocessing docs
Computer vision
- Pose estimation - A new Pose Estimation API with YOLO 26 docs
- FastSAM with prompts - Segment Anything style masks driven by point, box, or text prompts, fully on-device docs
General
- ExecuTorch runtime bumped to v1.2.0 - Updated native binaries and headers across iOS and Android, including the new
AlreadyLoadederror mapping docs - Typed
modelsregistry - A new declarativemodelsaccessor inconstants/modelRegistry.ts, grouped one-to-one with hooks, so you can pick a backend / precision without juggling URL constants docs - Extended tokenizer support - Rebuilt tokenizer binaries with unigram & word-level support, plus previously unsupported pre-tokenizers, decoders, and post-processors
- Graceful native-lib degradation on Android - Apps no longer crash at startup on 32-bit / unsupported ABIs;
isAvailable === falselets you render a fallback UI instead docs - iOS deployment target raised to 17.0 - Matches the prebuilt ExecuTorch libraries; apps targeting older iOS versions will need to bump
Breaking changes ⚠️
TextToImagereturns afile://URI instead of base64 —useTextToImage().generate()(andTextToImageModule.forward) now resolves to a path on disk pointing to a PNG, instead of a base64-encoded payload. Thepngjsdependency is no longer needed.- Multilingual TTS API reshape — The Kokoro pipeline now takes per-language voice / voice-quality configuration to support voice cloning and fine-tuned variants. Existing TTS call sites need to migrate.
- Speech-to-text quantized model constants removed — Predefined constants for quantized Whisper variants were dropped; the quality delta vs. the originals didn't justify the extra API surface. iOS now defaults to the new CoreML-backed Whisper builds.
OCRDetection.bboxis nowBbox, notPoint[]— The native vision stack moved to a unifiedPointstruct everywhere; consumers reading raw bbox geometry off OCR results need to update.ResourceFetcherAdapter.fetchreturn shape changed — Custom adapters must now return{ path: string; wasDownloaded: boolean }[]instead ofstring[], so callers can tell which resources were freshly downloaded vs. served from cache. Update any custom adapter implementations accordingly. docs
v0.8.4
v0.8.3
What's Changed
- chore: Update GitHub Actions and bump Node to 24 across all workflows… by @mkopcins in #1071
- chore: Release v0.8.3 by @msluszniak in #1072
Full Changelog: v0.8.2...v0.8.3
v0.8.2
v0.8.1
What's Changed
Added support for LFM2.5 350M: quantized 8da4w and base fp16 for XNNPACK.
Full Changelog: v0.8.0...v0.8.1
v0.9.0-libs-test (artifact download test)
Test release for validating on-demand native lib download flow. Not a real release.
v0.8.0
React Native ExecuTorch v0.8.0 👁️ ⚛️
This is the biggest and the most exciting release for us so far! If you're looking for processing camera input with AI models, running VLMs, or Bare RN support, look no more 👇
What's new?
Computer Vision
- VisionCamera integration: All computer vision hooks now expose a
runOnFrameworklet for real-time camera frame processing via VisionCamera v5 docs - Instance Segmentation: New
useInstanceSegmentationhook for per-pixel object masks, supporting YOLO (nano/small/medium/large/extra-large) and RF-DETR models docs - Object Detection: Added YOLO and RF-DETR model support docs
- Semantic Segmentation: Added support for DeepLab V3, LRASPP, FCN, and Selfie Segmentation models docs
- Quantized CV models: Added quantized variants for CLIP, Style Transfer, EfficientNetV2, and SSDLite
- Custom model support for Object Detection & Instance / Semantic Segmentation: Both modules are now generic — you can plug in your own model via
fromCustomModel()as long as it conforms to the expected input/output contract (see respective docs for further guidance)
VLMs
- Vision Language Models (VLMs):
useLLMnow supports multimodal models — passcapabilities: ['vision']and send images alongside messages docs - Added support for Liquid Foundation Models vision-language model (
LFM2_VL_1_6B_QUANTIZED).
LLMs
- LFM-2.5 support: Added support for Liquid Foundation Model 2.5 Instruct docs
- LLM context management: Added
ContextStrategytoChatConfig— configure naive, message-count-based, or sliding window context truncation.SlidingWindowContextStrategyis now the default
docs
Audio
- Whisper is now up to 3x faster
- TTS + LLM integration: Text-to-Speech streaming now accepts incrementally expanded text input, enabling real-time speech synthesis piped directly from a running LLM docs
- Kokoro TTS pre-computed phonemes: New
forwardFromPhonemes/streamFromPhonemesAPIs let you bypass the built-in G2P pipeline and supply your own IPA phoneme strings docs - Speech-to-Text timestamps:
transcribeandstreamnow returnTranscriptionResultobjects with word-level timestamps docs
General
- Bare React Native support: The library now officially supports bare React Native projects via
react-native-executorch-bare-resource-fetcherdocs - Modular resource fetcher adapters: Platform-specific adapters (
react-native-executorch-expo-resource-fetcher,react-native-executorch-bare-resource-fetcher) replace the previous monolithic fetcher, requiring explicit initialization viainitExecutorch()
docs - Uniform module factory API: All modules now expose
fromModelName()andfromCustomModel()static factories, replacing the oldnew Module() + load()pattern
Breaking changes ⚠️
initExecutorch()with an explicit adapter is now required before using any hook. Installreact-native-executorch-expo-resource-fetcherorreact-native-executorch-bare-resource-fetcherdepending on your project type
docs- All modules now use static factory methods (
Module.fromModelName()/Module.fromCustomModel()) — the oldnew Module()constructor +.load()pattern is removed ImageSegmentationhas been renamed toSemanticSegmentation— update imports and hook names accordingly (useSemanticSegmentation) docs- Semantic segmentation
resizeparameter renamed toresizeToInput - Semantic segmentation
forward()return type changed — now returnsRecord<'ARGMAX', Int32Array> & Record<K, Float32Array>instead ofnumber[] ObjectDetection.forward()now accepts anObjectDetectionOptionsobject for filtering classes of interestClassification.forward()return type changed — now returns a type-safe record of label names to scores instead ofRecord<string, number>StyleTransfer.forwardsignature changed — now acceptsstring | PixelDataand returnsPromise<PixelData | string>depending on theoutputparameter docs- Speech-to-Text:
transcribeandstreamnow returnTranscriptionResult(not raw strings).streamis now an async generator. Thecommitted/nonCommittedhook properties have been removed
docs - TTS streaming API changed —
TextToSpeechStreamingCallbackspattern replaced bystreamInsert()/streamStop()methods, andstream()is now an async generator docs - LLM
ChatConfig:contextWindowLengthhas been replaced bycontextStrategy
v0.7.2
v0.7.1
v0.7.0
Announcing React Native ExecuTorch v0.7.0 🌟
If you’re tired of robotic-sounding speech synthesizers, this one’s for you!
What’s new?
- Text to speech: Support for generating speech using Kokoro docs
- Reduced bundle size: We switched a library for tokenization, resulting in 64% reduction in package size
- OCR file sizes improvement: Previously, for the OCR pipeline to work, you needed 4 different model files. We made changes to use just one file, reducing the total file sizes by 3x (313MB -> 101MB) docs
- Improved error handling: The errors thrown from our library are now assigned a code property, allowing for fine-grained error handling docs
- LLMs: new stats API (getPromptTokenCount, getTotalTokenCount)
- LLMs: generate() API now returns a string, instead of void docs
- Our documentation now includes an API reference section
- General bug-fixes
Breaking changes ⚠️
- Removed
responseCallback()in LLM APIs - OCR now takes a single
modelSource, instead of 3. - Removed constants for VERTICAL_OCR. From now, only OCR_* constants should be used for both OCR and vertical OCR.
- Passing waveforms as
number[]in Speech to Text is now not supported anymore. Please useFloat32Arrayinstead. TokenizerModulewill now throwRnExecutorchErrorwhenidToTokenortokenToIdFails(for example when you pass a token outside of the vocab)- The
errorproperty in all of the hooks now is of type RnExecutorchError instead ofstring.