Wiro AI Open Source

Wiro AI open source / Realtime voice examples

ReactNative-Realtime

Realtime voice AI example app for React Native on Android and iOS: live conversation, speech-to-text and text-to-speech with the Wiro AI API.

View on GitHub Docs

Wiro AI

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.

React Native 0.87 Android API 26+ iOS 15.1+ CI License: MIT

Website · Models · Docs · Dashboard

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.

Conversation tab of the React Native app with a Start conversation button Transcription tab of the React Native app with a Start transcribing button Speech tab of the React Native app with a text-to-speech prompt and a Play button

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

Requirements

Run

Install JavaScript dependencies:

npm install

Copy the credential template and set the key:

cp .env.example .env

Edit .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 android

On iOS, install pods once, then run:

bundle install
cd ios && bundle exec pod install && cd ..
npm run ios -- --device

Credentials warning: .env values are bundled into the app
at build time via react-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:

How a conversation runs

REST:      https://api.wiro.ai/v1
WebSocket: wss://socket.wiro.ai/v1
Run:       POST /Run/{owner}/{model}
  1. POST /Run/{owner}/{model} returns a task id and a task token.
  2. A WebSocket opens and subscribes with
    { "type": "task_info", "tasktoken": "..." }.
  3. After task_stream_ready, 20 ms PCM chunks stream up as
    UTF8(tasktoken + "|") + pcm_bytes; audio and transcripts stream
    back.
  4. The app sends task_session_end on leave, which closes the
    session. A quiet session is closed by the server after 30 seconds
    without speech, and the app then receives task_end and
    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 test

Tests 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

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

Website · Models · Docs · X

License

MIT


Wiro AI koala mascot

Built by the Wiro AI team

wiro.ai · GitHub @wiroai