Converse Logo

Build with Converse

Add AI voice agents and chat to your app in minutes. Full SDK support across every platform.

5-Minute Quick Start

Get a voice agent running in your React app:

1

Install the SDK

bash
npm install @converse/sdk
2

Add voice to your component

tsx
import { useConverseVoice, ConverseOrb } from '@converse/sdk/components';

function VoiceAgent() {
  const { voiceState, agentState, connect, disconnect } = useConverseVoice({
    agentId: 'your-agent-id',
    tokenProvider: () => fetch('/api/token').then(r => r.json()),
  });

  return (
    <ConverseOrb
      state={agentState}
      size="lg"
      onClick={voiceState === 'idle' ? connect : disconnect}
    />
  );
}
3

Generate tokens on your backend

typescript
import { createTokenHandler } from '@converse/sdk/mobile';

// Next.js App Router: app/api/token/route.ts
export const POST = createTokenHandler({
  apiKey: process.env.CONVERSE_API_KEY!,
  allowedAgentIds: ['your-agent-id'],
  authorize: request => isSignedIn(request),
});

That's it

Audio, mic, speaker output, real-time state, transcription — all handled by the SDK internally. You write UI code, we handle infrastructure.

Available SDKs

Client / Server@converse/sdkWeb + Node.js (React, Next.js, Vanilla JS)
Client@converse/react-nativeReact Native (iOS + Android)
ClientConverseSDKiOS (Swift, SwiftUI)
Clientio.converse:converse-sdkAndroid (Kotlin, Compose)
Clientconverse_sdkFlutter (Dart)
Serverconverse-aiPython (Server)