React-Native Voice Assistant

This is a starter template for LiveKit Agents that provides a simple voice interface using the LiveKit React-Native SDK and Expo Plugin.

This template is free for you to use or modify as you see fit.

The easiest way to get this app running is with the LiveKit CLI.

Then, run the following command to automatically clone this template and connect it to LiveKit Cloud:

lk app create --template agent-starter-react-native

Afterwards, move to the newly created folder and run the following commands:

npm install

# Android
npx expo run:android

# iOS
npx expo run:ios

The app is configured to connect to the LiveKit homepage agent by default, which you can also try at livekit.com. To point the app at your own agent, see Connect to your agent.

To switch from the default agent to your own, you first need a LiveKit agent to speak with. For a no-code setup, use the Agent Builder. For more customization, try our starter agent for Python, Node.js, or create your own from scratch.

Second, you need a token server. For development, the easiest option is the sandbox token server: enable it from your project's Options on the Settings page in LiveKit Cloud and copy the sandboxId.

Then edit sandboxID in hooks/useConnection.tsx:

const sandboxID = 'your id here';

In a production environment, you will be responsible for developing a solution to generate tokens for your users which is integrated with your authentication solution. You should disable the token server and modify hooks/useConnectionDetails.ts to use your own token server.

This template is open source and we welcome contributions! Please open a PR or issue through GitHub, and don't forget to join us in the LiveKit Community Slack!