ElevenAgents React Native SDK

Build multimodal agents with ElevenAgents in React Native.

This package is a React Native companion to @elevenlabs/react. It re-exports the full conversation API and automatically configures the platform for voice conversations on React Native (WebRTC polyfills and native AudioSession setup).

Installation

npm install @elevenlabs/react-native @livekit/react-native @livekit/react-native-webrtc

The LiveKit peer dependencies provide the native WebRTC modules required for voice conversations in React Native.

Note: This SDK requires Expo development builds. Expo Go is not supported due to native module requirements.

Note: This package resolves its React Native entry point via the package.json "exports" field. Metro only resolves "exports" by default starting with Metro 0.82.0, which shipped in React Native 0.79.0 (released April 8, 2025). If you're on a React Native version older than 0.79, set resolver.unstable_enablePackageExports = true in your metro.config.js so this package resolves correctly:

const { getDefaultConfig } = require("metro-config");

const config = getDefaultConfig(__dirname);
config.resolver.unstable_enablePackageExports = true;

module.exports = config;

Quick Start

import {
  ConversationProvider,
  useConversationControls,
  useConversationStatus,
} from "@elevenlabs/react-native";

function App() {
  return (
    {/* replace with your agent's ID */}
    <ConversationProvider agentId="agent_7101k5zvyjhmfg983brhmhkd98n6">
      <Conversation />
    </ConversationProvider>
  );
}

function Conversation() {
  const { startSession, endSession } = useConversationControls();
  const { status } = useConversationStatus();

  return (
    <>
      <Text>Status: {status}</Text>
      <Button
        title="Start"
        onPress={() =>
          startSession({
            onConnect: ({ conversationId }) =>
              console.log("Connected:", conversationId),
            onError: (message) => console.error("Error:", message),
          })
        }
      />
      <Button title="End" onPress={() => endSession()} />
    </>
  );
}

Example App

See the Expo example app for a complete working example.

Documentation

For the full API reference, see the React Native SDK documentation.

Development

Please refer to the README.md file in the root of this repository.

Contributing

Please create an issue first to discuss the proposed changes. Any contributions are welcome!

Remember, if merged, your code will be used as part of a MIT licensed project. By submitting a Pull Request, you are giving your consent for your code to be integrated into this library.