Wiro Realtime for React Native: Voice AI Example for Android and iOS
Realtime voice AI for Android and iOS in React Native and TypeScript: live conversation, speech-to-text and text-to-speech with the Wiro AI API.
Wiro Realtime for React Native is the official open-source example for
building realtime voice AI into Android and iOS apps with React Native,
TypeScript and the Wiro AI API. Its three tabs stream audio over
WebSocket for a live speech-to-speech conversation with barge-in, live
speech-to-text from the microphone, and text-to-speech playback. The
auth, networking, realtime and audio layers have no React dependency,
so you can lift them into your own app.
What's inside
Three realtime audio flows, each a tab in the app, each backed by a
live Wiro AI model over one WebSocket protocol:
| Flow | Model | What it does |
|---|---|---|
| Conversation | openai/gpt-realtime-mini |
Full-duplex voice chat with barge-in |
| Transcription | mistralai/voxtral-mini-4b-realtime-2602 |
Live speech-to-text as you talk |
| Speech | openmoss/moss-tts-realtime or openbmb/voxcpm2 |
Streaming text-to-speech playback |
The chrome is react-native-paper Material 3, all system
components: bottom tabs, app bars, a floating toolbar for the live
call controls, an animated level meter driven by the real
microphone level, chat-bubble transcripts, and Material loading
indicators while connecting. Light and dark Wiro themes follow the
system. There is no custom orb, wave, or tab bar.
Features
- Live speech-to-speech conversation with voice activity detection,
barge-in, and a noise gate - Realtime microphone transcription with streaming partial results
- Streaming text-to-speech with bounded PCM playback
- One native audio graph per platform for capture and playback
(AudioRecord/AudioTrackon Android,AVAudioEngineon iOS)
behind a singleWiroPcmAudioTurboModule, so the platform echo
canceller (AEC) actually works - Signed REST Run requests and the full Wiro AI realtime WebSocket
protocol, in pure TypeScript - Bounded capture/playback queues, safe PCM overflow shedding, audio
route and interruption handling - Cross-feature guard so two tabs never hold the microphone at once
- Automatic reconnect to the same task on socket drops, with a
bounded restart budget - Session lifecycle covered by Jest unit tests and fakes, so no
device is needed to verify the plumbing
Requirements
- Node 22.11+
- A physical Android or iOS phone (the emulator or simulator
microphone is not a usable voice path) - Android: Android Studio (or the SDK) with compileSdk 37, minSdk 26
- iOS: Xcode with a valid signing team, CocoaPods, iOS 15.1+
- A Wiro AI project and API key
Run
Install JavaScript dependencies:
npm installCopy the credential template and set the key:
cp .env.example .envEdit .env:
WIRO_API_KEY=YOUR_API_KEY
WIRO_API_SECRET=
WIRO_API_SECRET is only for signature-based Wiro AI projects. Leave
it empty for API-key-only projects. .env is gitignored.
Launch fails fast when WIRO_API_KEY is missing.
Then, on Android, plug in a physical phone and run:
npm run androidOn iOS, install pods once, then run:
bundle install
cd ios && bundle exec pod install && cd ..
npm run ios -- --deviceCredentials warning:
.envvalues are bundled into the app
at build time viareact-native-config. Never distribute builds
containing real credentials: production apps should authenticate
through a controlled backend or a short-lived credential flow.
Make it yours
src/app/conversationConfig.ts
holds the persona, the voice, and the model. Editing that one file
is the whole of turning this example into a product.
PERSONA: '...who the assistant is...',
VOICE: 'marin',Common changes:
- Give the assistant a job: rewrite
PERSONA. - Change the voice: set
VOICEto any option the model catalog
lists (src/models/catalog.ts). - Tune the engineering parameters:
parametersoverrides the
catalog defaults for turn detection, audio formats, and rates. - Ship only the conversation: delete
src/ui/transcription/,
src/ui/speech/,src/services/transcription/, and
src/services/speech/(plus their*.test.tsfiles), then
remove the two destinations fromsrc/ui/home/screen.tsx.
Shared layers undermodels/,networking/,auth/,
realtime/, andaudio/are untouched.
How a conversation runs
REST: https://api.wiro.ai/v1
WebSocket: wss://socket.wiro.ai/v1
Run: POST /Run/{owner}/{model}
POST /Run/{owner}/{model}returns a task id and a task token.- A WebSocket opens and subscribes with
{ "type": "task_info", "tasktoken": "..." }. - After
task_stream_ready, 20 ms PCM chunks stream up as
UTF8(tasktoken + "|") + pcm_bytes; audio and transcripts stream
back. - The app sends
task_session_endon leave, which closes the
session. A quiet session is closed by the server after 30 seconds
without speech, and the app then receivestask_endand
task_postprocess_end.
Audio is signed 16-bit PCM, 24 kHz, mono, little-endian on both
sides.
Authentication is x-api-key alone, or x-api-key + x-nonce +
x-signature where the signature is
HMAC-SHA256(key = API_KEY, message = API_SECRET + NONCE).
Project layout
src/
app/ entry config, env, theme (Wiro light/dark)
models/ catalog, parameters, run result
networking/ HTTP client, endpoints, Run launcher
auth/ credentials, nonce, headers
realtime/ socket, session, framing
audio/ PCM constants, recorder/player queues, sink types
services/ Conversation / Transcription / Speech (no React)
ui/ navigation + screens
home/ conversation/ transcription/ speech/ shared/
specs/ TurboModule codegen spec (NativeWiroPcmAudio.ts)
android/ RN app + WiroPcmAudio Kotlin module
ios/ RN app + WiroPcmAudio Swift module
models/, networking/, auth/, realtime/, and audio/ have
no dependency on React or any screen service and cover the whole
Wiro AI integration, so they are the part worth lifting into your
own app. Tests mirror src/ and live next to the code
(*.test.ts); fakes live in support/ folders.
Tests
npm run lint && npm run typecheck && npm testTests mirror src/ and ship fakes for audio, network, and the
socket, so the entire session lifecycle runs without a device. CI
runs the same three commands on pushes to main and on pull
requests.
Contributing
Read CONTRIBUTING.md before opening a pull
request; AGENTS.md is the architecture document it
points at. To report a security problem, follow
SECURITY.md instead of opening a public issue.
Documentation
- Realtime voice guide
- Wiro AI documentation
- Available models
- Same example on other platforms:
Swift ·
Kotlin ·
Flutter - ReactNative-QuickStart:
Wiro AI SDK for React Native and Expo, published as@wiro-ai/wiro-react-nativeon npm
More from Wiro AI
| Repository | What it is |
|---|---|
| Wiro-MCP | Official MCP server for Wiro AI, @wiro-ai/wiro-mcp on npm |
| Wiro-LLM | Vercel AI SDK provider for chat, images, speech, transcription and video, @wiro-ai/wiro-llm on npm |
| Wiro-Chromium-Extension | Wiro AI extension for Chrome, Edge, Opera and Brave |
| Wiro-Firefox-Extension | Wiro AI add-on for Firefox |
| Wiro-Safari-Extension | Wiro AI extension for Safari on the Mac |
| Wiro-Plugin | Wiro AI plugin for Cursor, Claude Code, Gemini CLI, Devin, Antigravity and Kiro |
| Wiro-Skills | Agent skills for images, image edits, video, music, speech, transcripts, 3D and model search |
| Swift-QuickStart | WiroKit, the Wiro AI SDK for iOS |
| Kotlin-QuickStart | WiroKit, the Wiro AI SDK for Android |
| Dart-QuickStart | Wiro AI SDK for Dart and Flutter, wiro on pub.dev |
| ReactNative-QuickStart | Wiro AI SDK for React Native and Expo, @wiro-ai/wiro-react-native on npm |
| Swift-Realtime | Realtime voice AI example for iOS |
| Kotlin-Realtime | Realtime voice AI example for Android |
| Dart-Realtime | Realtime voice AI example for Flutter |
| n8n-nodes-wiro | One Wiro AI node for n8n with a searchable model picker, @wiro-ai/n8n-nodes-wiro on npm |
| Wiro-Dify-Plugin | Wiro AI plugins for Dify: the LLM gateway as a model provider, plus image, video, speech and music tools |
| Wiro-ComfyUI | Wiro AI nodes for ComfyUI |
| Wiro-Hermes | Wiro AI plugins for Hermes Agent: image, video, audio and 3D tools, plus the LLM gateway as a model provider |
| Wiro-Zed | Wiro AI MCP server extension for Zed |
| Wiro-Action | GitHub Action for Wiro AI models and the LLM gateway, on the GitHub Marketplace |
| Wiro-Raycast | Wiro AI extension for Raycast: image and video generation, LLM chat and model search |
| Wiro-WordPress | Wiro AI plugin for WordPress: featured images, image edits, alt text, narration and SEO suggestions |
| Wiro-Obsidian | Wiro AI plugin for Obsidian: images, video, speech, music, transcription and text tools |
| Wiro-Blender | Wiro AI add-on for Blender: text to 3D, image to 3D and textures |
| Wiro-Figma | Wiro AI plugin for Figma: images, vectors, image edits and text |
| Wiro-Next-Starter | Next.js starter for Wiro AI: Playground, image, video and audio tools, and LLM chat, ready for Vercel and Railway |
| Wiro-Docs | Source of the Wiro AI API docs |
| wiroai.github.io | Every open-source project from Wiro AI on one page, with a page for each repository |



