Prim Voices React Integration

A React library for integrating Prim Voices Agent functionality into your applications.

Features

🎤 Real-time microphone input capture
🔊 High-quality audio playback
📊 Audio level monitoring and speech detection
⚡ WebSocket-based communication
🔄 React Context integration

Installation

npm install primvoices-react

Quick Start

import { PrimVoicesProvider, usePrimVoices } from 'primvoices-react';

// Configure the provider
const config = {
  agentId: 'your-agent-id',
  environment: 'staged',
  logLevel: 'ERROR'
};

// Wrap your app with the provider
function App() {
  return (
    <PrimVoicesProvider config={config} autoConnect={true}>
      <YourComponent />
    </PrimVoicesProvider>
  );
}

// Use the hook in your components
function YourComponent() {
  const {
    connect,
    disconnect,
    startListening,
    stopListening,
    sendTextEvent,
    isConnected,
    isListening,
    isPlaying,
    audioStats,
    error
  } = usePrimVoices();

  // Your component logic here
}

Browser Support

• Chrome 74+

• Firefox 75+

• Safari 14.1+

• Edge 79+

Documentation

For more detailed documentation, visit our documentation page.