diff --git a/README.md b/README.md
index 27dec4df..25995e80 100644
--- a/README.md
+++ b/README.md
@@ -2,289 +2,156 @@
# React Native AI
-A collection of on-device AI primitives for React Native with first-class Vercel AI SDK support. Run AI models directly on users' devices for privacy-preserving, low-latency inference without server costs.
+**On-device AI for React Native, built on the [Vercel AI SDK](https://ai-sdk.dev).**
-## Features
+React Native AI is a set of packages that run AI models on your users' phones.
+Each provider package wraps one on-device runtime, such as Apple Intelligence
+on iOS, Gemini Nano on Android or llama.cpp on both, and exposes it as an AI
+SDK provider.
-- ๐ **Instant AI** - Use built-in system models immediately without downloads
-- ๐ **Privacy-first** - Inference runs on-device, so data stays local. Cloud models are opt-in
-- ๐ฏ **Vercel AI SDK compatible** - Use `generateText`, `streamText`, `embed` and other AI SDK functions with local models
-- ๐จ **Beyond text** - Embeddings, transcription, speech synthesis, image and video generation, and vision models
+## Providers
-## AI SDK Compatibility
+Providers come in two kinds: built-in models that ship with the operating
+system, and custom models that your app downloads or bundles.
-| React Native AI | AI SDK |
-| --------------- | ------ |
-| 0.11 and below | v5 |
-| 0.12 | v6 |
-| 0.13 and above | v7 |
+**Built-in models**
-## DevTools
+| Provider | Package | Platform | Models |
+| ----------------------------------------- | ------------------------------------------------ | -------- | ----------------------------------------------------------------------------------------------------- |
+| [Apple Intelligence](#apple-intelligence) | [`@react-native-ai/apple`](./packages/apple-llm) | iOS | Foundation Models on-device and on Private Cloud Compute, system embeddings, transcription and speech |
+| [Google ADK](#google-adk) | [`@react-native-ai/adk`](./packages/adk) | Android | Gemini Nano on-device, optional cloud Gemini |
-
+**Custom models**
-The AI SDK Profiler plugin captures OpenTelemetry spans from Vercel AI SDK
-requests and surfaces them in Rozenite DevTools. DevTools are runtime
-agnostic, so they work with on-device and remote runtimes.
+| Provider | Package | Platform | Models |
+| ---------------------------------- | ------------------------------------------------ | ------------ | ------------------------------------------------- |
+| [Llama](#llama) | [`@react-native-ai/llama`](./packages/llama) | iOS, Android | llama.cpp-compatible GGUF models |
+| [Core AI](#core-ai) (not released) | [`@react-native-ai/core-ai`](./packages/core-ai) | iOS 27+ | Model bundles exported with `apple/coreai-models` |
-```bash
-npm install @react-native-ai/dev-tools
-```
-
-Rozenite must be installed and enabled in your app. See the
-[Rozenite getting started guide](https://www.rozenite.dev/docs/getting-started).
+> [!TIP]
+> **Llama or Core AI?** Use Llama to run the same model on iOS and Android, or
+> a GGUF model from Hugging Face. Use Core AI when your app targets iOS 27+ and
+> you want Apple's own runtime, or need what Llama doesn't cover: image and
+> video generation, and vision tasks such as segmentation and object detection.
-If the `AI SDK Profiler` panel stays empty after you send a message, close the
-React Native DevTools window and open a new one. A stale debugger session can
-keep the panel mounted without receiving telemetry.
+### Apple Intelligence
-## Available Providers
-
-| Provider | Built-in | Platforms | Runtime | Description |
-| ------------------- | -------- | ------------ | ------------------------------------------------------------------- | ---------------------------------------------------------- |
-| [Apple](#apple) | โ
Yes | iOS | [Apple](https://developer.apple.com/documentation/FoundationModels) | Apple Foundation Models, embeddings, transcription, speech |
-| [ADK](#google-adk) | โ
Yes | Android | [Google ADK](https://developer.android.com/ai/adk) | On-device Gemini Nano, with optional cloud Gemini |
-| [Core AI](#core-ai) | โ No | iOS | [Core AI](https://github.com/apple/coreai-models) | Text, image, video, speech, embedding and vision models |
-| [Llama](#llama) | โ No | iOS, Android | [llama.rn](https://github.com/mybigday/llama.rn) | Run GGUF models via llama.rn |
-
----
-
-### Apple
-
-Native integration with Apple's on-device AI capabilities. **Built-in** - no model downloads required, uses system models.
-
-- **Text Generation** - Apple Foundation Models for chat and completion
-- **Embeddings** - NLContextualEmbedding for 512-dimensional semantic vectors
-- **Transcription** - SpeechAnalyzer for fast, accurate speech-to-text
-- **Speech Synthesis** - AVSpeechSynthesizer for natural text-to-speech with system voices
-
-#### Installation
+Use the models built into iOS: Foundation Models for text generation, on-device
+or on Private Cloud Compute, plus system models for embeddings, transcription
+and speech. Your app has nothing to bundle.
```bash
-npm install @react-native-ai/apple
+npm install @react-native-ai/apple ai
```
-No additional linking needed, works immediately on iOS devices (autolinked).
-
-#### Usage
-
-```typescript
+```ts
import { apple } from '@react-native-ai/apple'
-import {
- generateText,
- embed,
- transcribe,
- generateSpeech as speech,
-} from 'ai'
-
-// Text generation with Apple Intelligence
+import { generateText } from 'ai'
+
const { text } = await generateText({
model: apple(),
prompt: 'Explain quantum computing',
})
-
-// Generate embeddings
-const { embedding } = await embed({
- model: apple.embeddingModel(),
- value: 'Hello world',
-})
-
-// Transcribe audio
-const { text: transcript } = await transcribe({
- model: apple.transcriptionModel(),
- audio: audioBuffer,
-})
-
-// Text-to-speech
-const { audio } = await speech({
- model: apple.speechModel(),
- text: 'Hello from Apple!',
-})
```
-#### Availability
-
-| Feature | iOS Version | Additional Requirements |
-| ---------------- | ----------- | -------------------------- |
-| Text Generation | iOS 26+ | Apple Intelligence device |
-| Embeddings | iOS 17+ | - |
-| Transcription | iOS 26+ | - |
-| Speech Synthesis | iOS 13+ | iOS 17+ for Personal Voice |
-
-See the [Apple documentation](https://react-native-ai.dev/docs/apple/getting-started) for detailed setup and usage guides.
-
----
+[Package README](./packages/apple-llm) ยท [Documentation](https://react-native-ai.dev/docs/apple/getting-started)
### Google ADK
-Run Gemini Nano on-device on Android through Google's [Agent Development Kit](https://developer.android.com/ai/adk). **Built-in** - Gemini Nano is provisioned by the system via AICore, so there are no model files to bundle and no API key. Cloud Gemini is available as an option.
-
-- **Text Generation** - `generateText` and `streamText` with on-device Gemini Nano
-- **Tool Calling** - Native ADK agent loop with JavaScript tool executors
-- **Cloud Gemini** - Optional cloud inference via ADK `LlmAgent` when you need a larger model
-
-#### Installation
+Use Gemini on Android through Google's
+[Agent Development Kit](https://developer.android.com/ai/adk). Gemini Nano runs
+on-device and is provided by the system through AICore, so there are no model
+files and no API key. Cloud Gemini is available when you need a larger model.
```bash
-npm install @react-native-ai/adk
+npm install @react-native-ai/adk ai
```
-> [!IMPORTANT]
-> Requires Android `minSdkVersion` 26 and a physical device with AICore support (Android 14+) for Gemini Nano. Your app also needs packaging excludes for duplicate `META-INF` files, see the [getting started guide](https://react-native-ai.dev/docs/adk/getting-started).
-
-#### Usage
-
-```typescript
+```ts
import { adk } from '@react-native-ai/adk'
import { generateText } from 'ai'
-if (!(await adk.isAvailable())) {
- throw new Error('Gemini Nano is not available on this device')
-}
-
-await adk.prepareNano()
-
const { text } = await generateText({
model: adk(),
prompt: 'Explain quantum computing',
})
```
-See the [ADK documentation](https://react-native-ai.dev/docs/adk/getting-started) for device checks, cloud Gemini, and tool calling.
-
----
-
-### Core AI
-
-Run models exported with Apple's [`coreai-models`](https://github.com/apple/coreai-models) on Apple's Core AI runtime, on iOS 27 devices. Your app downloads or bundles the models, and every task has a [hosted export](https://react-native-ai.dev/docs/core-ai/models) to start from, except raw function calls, which run your own `.aimodel`.
-
-- **Text Generation** - Qwen3 and other LLM exports, with structured output, tool calling and reasoning
-- **Image Prompts** - Qwen3-VL answers questions about an image
-- **Image and Video Generation** - FLUX.2 diffusion pipelines, and Wan 2.1 video on macOS (it does not fit in iPhone memory yet)
-- **Transcription** - Parakeet TDT, for files and live audio
-- **Embeddings** - CLIP text and image embeddings in one space
-- **Vision** - Object detection, segmentation, video tracking, super-resolution, classification and depth
-- **Any `.aimodel`** - Raw function calls with tensors and images
-
-#### Installation
-
-```bash
-npm install @react-native-ai/core-ai @react-native-ai/apple ai
-```
-
-> [!IMPORTANT]
-> Requires Xcode 27, an iOS 27 deployment target and a physical device: the iOS Simulator has no Core AI framework. With Expo, add the `@react-native-ai/core-ai` config plugin.
-
-#### Usage
-
-```typescript
-import { coreAI } from '@react-native-ai/core-ai'
-import { generateImage, streamText, transcribe } from 'ai'
-
-// Text generation with an exported Qwen3
-const result = streamText({
- model: coreAI.languageModel({
- id: 'qwen3-0.6b',
- source: qwen3,
- }),
- prompt: 'Explain Core AI in one sentence.',
-})
-
-for await (const delta of result.textStream) {
- console.log(delta)
-}
-
-// Image generation with FLUX.2 klein
-const { image } = await generateImage({
- model: coreAI.imageModel({
- id: 'flux2-klein-4b',
- source: flux,
- }),
- prompt: 'a red apple on a wooden table',
-})
-
-// Transcription with Parakeet TDT
-const { text } = await transcribe({
- model: coreAI.transcriptionModel({
- id: 'parakeet',
- source: parakeet,
- }),
- audio: recording,
-})
-```
-
-See the [Core AI documentation](https://react-native-ai.dev/docs/core-ai/getting-started) for native setup, every task and the hosted models.
-
----
+[Package README](./packages/adk) ยท [Documentation](https://react-native-ai.dev/docs/adk/getting-started)
### Llama
-Run any GGUF model on-device using [llama.rn](https://github.com/mybigday/llama.rn). **Requires download** - models are downloaded from HuggingFace.
-
-#### Supported Features
-
-| Feature | Method | Description |
-| --------------- | ------------------------ | --------------------------------------------- |
-| Text Generation | `llama.languageModel()` | Chat, completion, streaming, reasoning models |
-| Embeddings | `llama.embeddingModel()` | Text embeddings for RAG and similarity search |
-| Speech | `llama.speechModel()` | Text-to-speech with vocoder models |
-
-#### Installation
+Run llama.cpp-compatible GGUF models from Hugging Face on iOS and Android with
+[llama.rn](https://github.com/mybigday/llama.rn). Supports text generation,
+embeddings, reranking and speech.
```bash
-npm install @react-native-ai/llama llama.rn react-native-blob-util
+npm install @react-native-ai/llama llama.rn react-native-blob-util ai
```
-#### Usage
-
-```typescript
+```ts
import { downloadModel, llama } from '@react-native-ai/llama'
import { generateText } from 'ai'
-// Download from HuggingFace (Model ID format: "owner/repo/filename.gguf")
+// Model ID format: "owner/repo/filename.gguf"
const modelPath = await downloadModel(
- 'bartowski/Qwen_Qwen3.5-2B-GGUF/Qwen_Qwen3.5-2B-Q4_K_M.gguf',
- (progress) => console.log(`Downloading: ${progress.percentage}%`)
+ 'bartowski/Qwen_Qwen3.5-2B-GGUF/Qwen_Qwen3.5-2B-Q4_K_M.gguf'
)
-// Create model instance
const model = llama.languageModel(modelPath)
-
-// Initialize model (loads into memory)
await model.prepare()
-// Generate text
const { text } = await generateText({
model,
- messages: [
- { role: 'system', content: 'You are a helpful assistant.' },
- { role: 'user', content: 'Write a haiku about coding.' },
- ],
+ prompt: 'Write a haiku about coding.',
})
-// Cleanup when done
+// Release the native context when you no longer need the model
await model.unload()
```
-#### Model Compatibility
+[Package README](./packages/llama) ยท [Documentation](https://react-native-ai.dev/docs/llama/getting-started)
-Any GGUF model from HuggingFace can be used. Use the format `owner/repo/filename.gguf` as the model ID. Popular choices include:
+### Core AI
-- `bartowski/Qwen_Qwen3.5-2B-GGUF/Qwen_Qwen3.5-2B-Q4_K_M.gguf`
-- `bartowski/Llama-3.2-3B-Instruct-GGUF/Llama-3.2-3B-Instruct-Q4_K_M.gguf`
-- `Qwen/Qwen2.5-1.5B-Instruct-GGUF/qwen2.5-1.5b-instruct-q4_k_m.gguf`
+Not published to npm yet. Run models exported with
+[`apple/coreai-models`](https://github.com/apple/coreai-models), such as Qwen3
+or FLUX.2, on iOS 27 with Apple's Core AI framework. Every task has a
+[hosted export](https://react-native-ai.dev/docs/core-ai/models) to start
+from: text generation with tool calling and image prompts, image and video
+generation, transcription, embeddings, and vision tasks such as segmentation
+and object detection.
-๐ **[View full Llama documentation โ](https://react-native-ai.dev/docs/llama/getting-started)**
+```ts
+import { coreAI } from '@react-native-ai/core-ai'
+import { streamText } from 'ai'
-## JSON UI
+const result = streamText({
+ // A model folder shipped in the app bundle, or a path in app storage
+ model: coreAI.languageModel({ source: 'bundle://models/qwen3-0.6b' }),
+ prompt: 'Explain Core AI in one sentence.',
+})
+```
-`@react-native-ai/json-ui` lets a tool-calling model build React Native UI. The model calls tools that add, update, and delete nodes in a JSON spec, and `GenerativeUIView` renders it. It's designed for small on-device models with limited context.
+[Package README](./packages/core-ai) ยท [Documentation](https://react-native-ai.dev/docs/core-ai/getting-started)
-```bash
-npm install @react-native-ai/json-ui
-```
+## Tools
+
+These work with any AI SDK provider, on-device or cloud.
+
+| Package | Description |
+| ---------------------------------------------------- | ------------------------------------------------------------------------- |
+| [`@react-native-ai/json-ui`](./packages/json-ui) | Let a tool-calling model build React Native UI from a JSON spec |
+| [`@react-native-ai/dev-tools`](./packages/dev-tools) | Inspect AI SDK calls in Rozenite DevTools |
+| [`@react-native-ai/utils`](./packages/utils) | Compact conversation history for small context windows (not released yet) |
+
+## AI SDK Compatibility
-See the [JSON UI documentation](https://react-native-ai.dev/docs/json-ui/getting-started).
+| React Native AI | AI SDK |
+| --------------- | ------ |
+| 0.11 and below | v5 |
+| 0.12 | v6 |
+| 0.13 and above | v7 |
## Documentation
diff --git a/packages/adk/README.md b/packages/adk/README.md
index ac720cbd..8973a0e1 100644
--- a/packages/adk/README.md
+++ b/packages/adk/README.md
@@ -1,6 +1,18 @@
-# ADK Provider for Vercel AI SDK
+# @react-native-ai/adk
-A Vercel AI SDK provider for [Google's Agent Development Kit (ADK)](https://developer.android.com/ai/adk) on Android. Use on-device Gemini Nano or cloud Gemini with tool calling and multi-turn sessions.
+Add Gemini to your Android app without shipping a model or an API key. Gemini
+Nano runs on-device through Google's
+[Agent Development Kit (ADK)](https://developer.android.com/ai/adk) and
+AICore, for chat, summaries and tool-using assistants that keep data on the
+device. AICore downloads Nano the first time `prepareNano()` runs, if the
+device doesn't have it yet. When you need a larger model, switch to cloud
+Gemini.
+
+It also comes as a [Vercel AI SDK](https://ai-sdk.dev) provider, so it drops
+into code that already uses the AI SDK.
+
+To run models you choose and ship yourself on Android, see
+[`@react-native-ai/llama`](../llama).
**Requirements:**
diff --git a/packages/apple-llm/README.md b/packages/apple-llm/README.md
index 46f9d810..075f28ad 100644
--- a/packages/apple-llm/README.md
+++ b/packages/apple-llm/README.md
@@ -1,68 +1,118 @@
-# Apple Provider for Vercel AI SDK
+# @react-native-ai/apple
-A Vercel AI SDK provider for Apple Foundation Models, enabling access to Apple Intelligence in React Native applications.
+Add AI features to your iOS app without shipping a model. Chat, summaries,
+structured data extraction and tool-using assistants run on Apple Intelligence,
+and semantic search, voice input and spoken output run on system models. Data
+stays on the device, there are no API costs, and your app stays small, since
+iOS provides the models.
-**Requirements:**
+When a task needs more than the on-device model, iOS 27 can send it to Apple's
+Private Cloud Compute instead. It also comes as a
+[Vercel AI SDK](https://ai-sdk.dev) provider, so it drops into code that
+already uses the AI SDK.
-- iOS 26+ for text generation
-- iOS 26.4+ for token counting
-- iOS 26.4 for Image Playground generation, which Apple removed in iOS 27
-- iOS 27+ for image prompts, Private Cloud Compute, and Vision built-in tools
-- Apple Intelligence enabled device
-- Vercel AI SDK v7
+To run models you choose and ship yourself, see
+[`@react-native-ai/core-ai`](../core-ai) or
+[`@react-native-ai/llama`](../llama).
+
+## Features
+
+| Capability | Apple framework | AI SDK function | iOS |
+| ---------------- | -------------------------------------------------------------------------------------------------------- | --------------------------- | ---- |
+| Text generation | [Foundation Models](https://developer.apple.com/documentation/FoundationModels) | `generateText`/`streamText` | 26+ |
+| Embeddings | [NLContextualEmbedding](https://developer.apple.com/documentation/naturallanguage/nlcontextualembedding) | `embed`/`embedMany` | 17+ |
+| Transcription | [SpeechAnalyzer](https://developer.apple.com/documentation/speech/speechanalyzer) | `transcribe` | 26+ |
+| Speech synthesis | [AVSpeechSynthesizer](https://developer.apple.com/documentation/avfaudio/avspeechsynthesizer) | `generateSpeech` | 13+ |
+| Image generation | Image Playground | `generateImage` | 26.4 |
+
+Text generation supports streaming, structured output, tool calling, image
+prompts, reasoning levels and Private Cloud Compute. Each capability also has a
+native API (`AppleFoundationModels`, `AppleEmbeddings`, `AppleTranscription`,
+`AppleSpeech`) for features outside the AI SDK, such as live microphone
+transcription on iOS 27 and voice listing.
+
+## Requirements
+
+- iOS 26+ and a device with Apple Intelligence enabled, for text generation
- React Native New Architecture
+- Vercel AI SDK v7
+
+## Installation
+
+```bash
+npm install @react-native-ai/apple ai
+```
+
+The package is autolinked, so there is no native setup. The one exception is
+live microphone transcription (`AppleTranscription.transcribeLive`), which
+needs a microphone usage description in `Info.plist`:
+
+```xml
+NSMicrophoneUsageDescription
+Transcribe what you say.
+```
+
+## Usage
```ts
import { apple } from '@react-native-ai/apple'
-import { generateText } from 'ai'
+import { embed, generateSpeech, generateText, transcribe } from 'ai'
+
+// Recorded audio, for example a WAV file read into a Uint8Array
+declare const audioBuffer: Uint8Array
-const answer = await generateText({
+const { text } = await generateText({
model: apple(),
- prompt: 'What is the meaning of life?',
+ prompt: 'Explain quantum computing in one sentence.',
+})
+
+const { embedding } = await embed({
+ model: apple.embeddingModel(),
+ value: 'Hello world',
+})
+
+const { text: transcript } = await transcribe({
+ model: apple.transcriptionModel(),
+ audio: audioBuffer,
+})
+
+const { audio } = await generateSpeech({
+ model: apple.speechModel(),
+ text: 'Hello from Apple!',
})
```
-For reusable history utilities such as summarization, rolling windows, and
-completed tool-call pruning, use `@react-native-ai/utils`.
+Check `await apple.isAvailable()` before generating text, since Apple
+Intelligence can be off or still downloading. For long chats on the small
+on-device context window, wrap the model with
+[`@react-native-ai/utils`](../utils) (not published to npm yet).
## iOS 26 and iOS 27
The provider runs on both. iOS 26.4 and iOS 27 features also need an app built
with an SDK that has them (Xcode 26 with Swift 6.3, and Xcode 27).
-| Feature | iOS 26 | iOS 26.4 | iOS 27 |
-| ------------------------------------ | ------ | -------- | ----------------------- |
-| Text, streaming, structured output | โ
| โ
| โ
|
-| JavaScript tools | โ
| โ
| โ
|
-| Tool calls while streaming | โ | โ | โ
|
-| `toolChoice: 'auto'` and `'none'` | โ
| โ
| โ
|
-| `toolChoice: 'required'`, named tool | โ | โ | โ
|
-| Token counting and context size | โ | โ
| โ
|
-| Image Playground generation | โ | โ
| โ Removed by Apple |
-| Reasoning level and reasoning parts | โ | โ | โ
|
-| Image prompts | โ | โ | โ
|
-| Private Cloud Compute | โ | โ | โ
Physical device only |
-| Vision OCR and barcode tools | โ | โ | โ
Physical device only |
-| Token usage | โ | โ | โ
|
+| Feature | iOS 26 | iOS 26.4 | iOS 27 |
+| --------------------------------------- | ------ | -------- | ----------------------- |
+| Text, streaming, structured output | โ
| โ
| โ
|
+| JavaScript tools | โ
| โ
| โ
|
+| Tool calls while streaming | โ | โ | โ
|
+| `toolChoice: 'auto'` and `'none'` | โ
| โ
| โ
|
+| `toolChoice: 'required'`, named tool | โ | โ | โ
|
+| Token counting and context size | โ | โ
| โ
|
+| Image Playground generation | โ | โ
| โ Removed by Apple |
+| Reasoning level and reasoning parts | โ | โ | โ
|
+| Image prompts | โ | โ | โ
|
+| Private Cloud Compute | โ | โ | โ
Physical device only |
+| Vision OCR, barcode and Spotlight tools | โ | โ | โ
Physical device only |
+| Token usage | โ | โ | โ
|
+| Live microphone transcription | โ | โ | โ
Physical device only |
See [iOS Versions](https://react-native-ai.dev/docs/apple/ios-versions) for details.
-## Features
-
-- โ
Text generation with Apple Foundation Models
-- โ
Image prompts on iOS 27+
-- โ
Runtime model info and context-size metadata
-- โ
Private Cloud Compute language model selection on iOS 27+
-- โ
Reasoning level control on iOS 27+
-- โ
Structured outputs
-- โ
Tool calling
-- โ
Vision OCR and barcode built-in tools on iOS 27+
-- โ
Streaming
-- โ
Image Playground generation through the AI SDK image API on iOS 26.4 (deprecated)
-
## Documentation
-For complete installation instructions and API documentation, visit our [documentation site](https://react-native-ai.dev/docs/apple/getting-started).
+Guides and API reference are on the [documentation site](https://react-native-ai.dev/docs/apple/getting-started).
## License
diff --git a/packages/core-ai/README.md b/packages/core-ai/README.md
index a405e798..c28fc100 100644
--- a/packages/core-ai/README.md
+++ b/packages/core-ai/README.md
@@ -1,8 +1,16 @@
# @react-native-ai/core-ai
-Apple Core AI provider for React Native AI. It runs model bundles exported with [`apple/coreai-models`](https://github.com/apple/coreai-models) on Apple's Core AI runtime, with the Vercel AI SDK and direct native calls.
+Bring your own model to iPhone and run it on Apple's Core AI framework. Start
+from a [hosted export](https://react-native-ai.dev/docs/core-ai/models), such
+as Qwen3 for chat or FLUX.2 for images, or export your own with
+[`apple/coreai-models`](https://github.com/apple/coreai-models), and run it
+on-device from React Native. Use it for text, image and video generation, transcription, embeddings,
+and vision tasks such as segmentation and object detection.
-For Apple's built-in system models (Foundation Models, NLContextualEmbedding, SpeechAnalyzer, AVSpeechSynthesizer), use `@react-native-ai/apple`.
+It also comes as a [Vercel AI SDK](https://ai-sdk.dev) provider, so it drops
+into code that already uses the AI SDK.
+
+For Apple's built-in system models (Foundation Models, NLContextualEmbedding, SpeechAnalyzer, AVSpeechSynthesizer), use [`@react-native-ai/apple`](../apple-llm).
| Task | API |
| ---------------- | ------------------------------------------------------------------------------------------------------------------ |
diff --git a/packages/dev-tools/README.md b/packages/dev-tools/README.md
index ac99e5e8..0b67d625 100644
--- a/packages/dev-tools/README.md
+++ b/packages/dev-tools/README.md
@@ -1,10 +1,11 @@

-### A Rozenite plugin that captures Vercel AI SDK spans in Rozenite
+# @react-native-ai/dev-tools
-The AI SDK Profiler plugin captures OpenTelemetry spans emitted by the Vercel AI
-SDK and shows them in Rozenite DevTools. It helps you inspect requests,
-inputs, outputs, provider metadata, and latency.
+See every Vercel AI SDK call your React Native app makes. The AI SDK Profiler
+is a [Rozenite](https://www.rozenite.dev) DevTools plugin that captures the
+OpenTelemetry spans the AI SDK emits and shows their inputs, outputs, tool
+calls, provider metadata and latency.

@@ -27,31 +28,28 @@ https://www.rozenite.dev/docs/getting-started
### 1. Initialize the tracer and DevTools hook
```tsx
-import {
- getAiSdkTracer,
- useAiSdkDevTools,
-} from '@react-native-ai/dev-tools';
+import { getAiSdkTracer, useAiSdkDevTools } from '@react-native-ai/dev-tools'
export function App() {
- useAiSdkDevTools();
- return ;
+ useAiSdkDevTools()
+ return
}
```
### 2. Enable AI SDK telemetry on requests
```ts
-import { OpenTelemetry } from '@ai-sdk/otel';
-import { generateText, registerTelemetry } from 'ai';
-import { openai } from '@ai-sdk/openai';
-import { getAiSdkTracer } from '@react-native-ai/dev-tools';
+import { OpenTelemetry } from '@ai-sdk/otel'
+import { generateText, registerTelemetry } from 'ai'
+import { openai } from '@ai-sdk/openai'
+import { getAiSdkTracer } from '@react-native-ai/dev-tools'
// Register once, at app startup
registerTelemetry(
new OpenTelemetry({
tracer: getAiSdkTracer({ serviceName: 'my-app' }),
})
-);
+)
await generateText({
model: openai('gpt-4o-mini'),
@@ -59,7 +57,7 @@ await generateText({
telemetry: {
functionId: 'unique-identifier-where-the-call-comes-from',
},
-});
+})
```
### 3. Open DevTools
diff --git a/packages/json-ui/README.md b/packages/json-ui/README.md
index a55bd291..3f38559e 100644
--- a/packages/json-ui/README.md
+++ b/packages/json-ui/README.md
@@ -1,6 +1,9 @@
-# `@react-native-ai/json-ui`
+# @react-native-ai/json-ui
-Lightweight JSON UI tooling for React Native + Vercel AI SDK tool calling.
+Let a language model build React Native UI. The model calls tools that add,
+update and remove nodes in a JSON spec, and `GenerativeUIView` renders it. It
+plugs into Vercel AI SDK tool calling, and is designed for small on-device
+models with limited context.
**This package provides:**
diff --git a/packages/llama/README.md b/packages/llama/README.md
index 1748c239..ed787607 100644
--- a/packages/llama/README.md
+++ b/packages/llama/README.md
@@ -1,45 +1,79 @@
-# Llama Provider for Vercel AI SDK
+# @react-native-ai/llama
-A Vercel AI SDK provider for llama.rn, enabling on-device inference with GGUF models in React Native applications.
+Pick an open-weight model and run it on iOS and Android. Download a GGUF model
+such as Qwen, Llama or Gemma from Hugging Face and run it fully on-device with
+[llama.rn](https://github.com/mybigday/llama.rn), for chat, semantic search,
+reranking or speech, with the same model on both platforms.
-**Requirements:**
-- React Native >= 0.76.0
-- llama.rn >= 0.13.0-rc.8 (required for React Native 0.88)
+It also comes as a [Vercel AI SDK](https://ai-sdk.dev) provider, so it drops
+into code that already uses the AI SDK.
+
+Use it when you need the same models on both platforms, or a model the system
+doesn't provide. For models built into the OS, see
+[`@react-native-ai/apple`](../apple-llm) (iOS) and
+[`@react-native-ai/adk`](../adk) (Android).
+
+## Features
+
+| Capability | Method | AI SDK function | Model |
+| --------------- | ------------------------ | --------------------------- | --------------------------------------- |
+| Text generation | `llama.languageModel()` | `generateText`/`streamText` | Chat or instruct model |
+| Embeddings | `llama.embeddingModel()` | `embed`/`embedMany` | Embedding model |
+| Reranking | `llama.rerankingModel()` | `rerank` | Reranker model |
+| Speech | `llama.speechModel()` | `generateSpeech` | TTS model and a vocoder (`vocoderPath`) |
+
+Language models support:
+
+- Streaming
+- Reasoning, controlled with the AI SDK `reasoning` option
+- Structured output (`Output.object`), enforced with a JSON schema grammar
+- Tool calling
+- Vision and audio input with a multimodal projector (`projectorPath`)
+- GPU acceleration
+
+Model download management (`downloadModel`, `getDownloadedModels`,
+`removeModel`) is included.
+
+## Requirements
+
+- React Native 0.76+
+- llama.rn 0.13.0-rc.8+ (required for React Native 0.88)
- Vercel AI SDK v7
+## Installation
+
+```bash
+npm install @react-native-ai/llama llama.rn react-native-blob-util ai
+```
+
+## Usage
+
```ts
import { downloadModel, llama } from '@react-native-ai/llama'
import { generateText } from 'ai'
-// Download (format: "owner/repo/filename.gguf") and prepare
+// Model ID format: "owner/repo/filename.gguf"
const modelPath = await downloadModel(
- 'bartowski/Qwen_Qwen3.5-2B-GGUF/Qwen_Qwen3.5-2B-Q4_K_M.gguf'
+ 'bartowski/Qwen_Qwen3.5-2B-GGUF/Qwen_Qwen3.5-2B-Q4_K_M.gguf',
+ (progress) => console.log(`Downloading: ${progress.percentage}%`)
)
+
const model = llama.languageModel(modelPath)
await model.prepare()
-// Generate
const { text } = await generateText({
model,
- prompt: 'Write a haiku about coding.'
+ prompt: 'Write a haiku about coding.',
})
-```
-## Features
+await model.unload()
+```
-- โ
Text generation with GGUF models
-- โ
Streaming
-- โ
Reasoning, controlled with the AI SDK `reasoning` option
-- โ
Structured output (`Output.object`), enforced with a JSON schema grammar
-- โ
Tool calling
-- โ
Vision and audio input with a multimodal projector (`projectorPath`)
-- โ
On-device inference (iOS & Android)
-- โ
Model download management
-- โ
GPU acceleration support
+Any GGUF model from Hugging Face whose architecture llama.cpp supports works.
## Documentation
-For complete installation instructions and API documentation, visit our [documentation site](https://react-native-ai.dev/docs/llama/getting-started).
+Guides and API reference are on the [documentation site](https://react-native-ai.dev/docs/llama/getting-started).
## License
diff --git a/packages/utils/README.md b/packages/utils/README.md
index 0a21144b..e544cca7 100644
--- a/packages/utils/README.md
+++ b/packages/utils/README.md
@@ -1,6 +1,9 @@
-# React Native AI Utils
+# @react-native-ai/utils
-Shared utilities for React Native AI SDK providers.
+Keep long chats working on small on-device context windows.
+`wrapLanguageModelWithHistory` wraps any Vercel AI SDK language model,
+including the Apple, Llama and ADK providers, and compacts the conversation
+before each request.
> Not published to npm yet. Use it from this monorepo, or copy
> `src/index.ts` into your app. Its only dependency is `@ai-sdk/provider`.