> ## Documentation Index
> Fetch the complete documentation index at: https://docs.upliftai.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Realtime Voice Assistants

> Build conversational AI agents with UpliftAI

<Note>
  **New in Beta**: Our Realtime Assistants API lets you create voice-enabled AI agents that can have natural conversations with users.
</Note>

## Quick Overview

Realtime Assistants combine UpliftAI's speech technology with conversational AI to create voice agents that can:

* 🎯 **Respond in \~1 second** end-to-end
* 🗣️ **Handle interruptions** naturally
* 🛠️ **Execute custom tools** on the user's device
* 🌍 **Support multiple languages** including Urdu, Sindhi, and Balochi
* 🔄 **Update behavior dynamically** during conversations

## Perfect for Voice Applications

If you're using our Orator TTS API, Realtime Assistants take it to the next level by adding:

* Full conversational capabilities
* Context awareness
* Tool execution
* WebRTC streaming

## Example Use Cases

* **Customer Support** - 24/7 voice agents
* **E-commerce** - Voice shopping assistants
* **Healthcare** - Patient intake systems
* **Education** - Interactive tutors

## Get Started

<Card title="View Full Documentation" icon="book" href="/assistants/introduction">
  Explore the complete Realtime Assistants documentation including tutorials, API reference, and SDK guides.
</Card>

## Quick Example

Create a voice assistant in minutes:

```javascript theme={null}
// 1. Create an assistant (via API)
const assistant = await createAssistant({
  name: 'Shopping Assistant',
  config: {
    agent: {
      instructions: 'Help users shop for products',
      initialGreeting: true
    },
    stt: { default: { provider: 'groq', model: 'whisper-large-v3' }},
    tts: { default: { provider: 'upliftai', voiceId: 'v_meklc281' }},
    llm: { default: { provider: 'groq', model: 'openai/gpt-oss-120b' }}
  }
});

// 2. Connect from your app
import { UpliftAIRoom } from '@upliftai/assistants-react';

<UpliftAIRoom token={sessionToken} serverUrl={wsUrl}>
  <YourAssistantUI />
</UpliftAIRoom>
```

## Integration with Orator

Realtime Assistants use the same high-quality TTS voices from Orator, but add:

* Automatic speech recognition (STT)
* Conversation management
* Tool calling capabilities
* Real-time streaming via WebRTC

<CardGroup cols={2}>
  <Card title="Try the Tutorial" icon="graduation-cap" href="/assistants/tutorial">
    Build your first assistant in 10 minutes
  </Card>

  <Card title="API Reference" icon="code" href="/assistants/api-reference/create-assistant">
    Explore all endpoints and options
  </Card>
</CardGroup>