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

# Install orb-ui for React

> Install orb-ui, import the Orb component, and choose the integration path for your voice agent UI.

Install orb-ui from npm:

```bash theme={null}
npm install orb-ui
```

orb-ui ships React components and TypeScript types. React and React DOM are peer dependencies, so your app should already include them.

```tsx theme={null}
import { Orb } from 'orb-ui'

export function VoiceAgentStatus() {
  return <Orb state="idle" theme="circle" />
}
```

## Provider SDKs

Provider adapters live in the `orb-ui/adapters` entrypoint, but orb-ui does not bundle provider SDKs. Install the SDK for the provider you use:

```bash theme={null}
# Vapi
npm install orb-ui @vapi-ai/web

# ElevenLabs Conversational AI
npm install orb-ui @elevenlabs/client

# LiveKit Agents
npm install orb-ui livekit-client

# Pipecat (add the transport used by your agent)
npm install orb-ui @pipecat-ai/client-js @pipecat-ai/small-webrtc-transport

# OpenAI Live and Realtime use browser WebRTC and need no additional client SDK
npm install orb-ui

# Gemini Live
npm install orb-ui @google/genai
```

```tsx theme={null}
import {
  createElevenLabsAdapter,
  createGeminiLiveAdapter,
  createOpenAILiveAdapter,
  createOpenAIRealtimeAdapter,
  createPipecatAdapter,
  createVapiAdapter,
} from 'orb-ui/adapters'
import { createLiveKitAdapter } from 'orb-ui/adapters/livekit'
```

Use an adapter when a supported provider owns the voice session. Use controlled mode when your app already has session state and audio volume.

## Choose an integration path

* Start with the [adapter overview](https://orb-ui.com/docs/adapters/overview.md) to compare the browser and server
  responsibilities for each provider.
* Use [controlled mode](https://orb-ui.com/docs/adapters/custom.md) when you are prototyping or wiring a custom realtime voice stack.
* Use the [Vapi adapter](https://orb-ui.com/docs/adapters/vapi.md) for Vapi assistants.
* Use the [ElevenLabs adapter](https://orb-ui.com/docs/adapters/elevenlabs.md) for ElevenLabs conversational agents.
* Use the [LiveKit adapter](https://orb-ui.com/docs/adapters/livekit.md) for LiveKit Agents.
* Use the [Pipecat adapter](https://orb-ui.com/docs/adapters/pipecat.md) with Pipecat Cloud, Daily, or self-hosted SmallWebRTC agents.
* Start with the [OpenAI GPT-Live adapter](https://orb-ui.com/docs/adapters/openai-live.md) for full-duplex voice sessions.
* Use the [OpenAI Realtime adapter](https://orb-ui.com/docs/adapters/openai-realtime.md) for existing Realtime integrations.
* Use the [Gemini Live adapter](https://orb-ui.com/docs/adapters/gemini-live.md) for native-audio Live API sessions.

## Next steps

* [Quickstart](https://orb-ui.com/docs/quickstart.md)
* [Orb component API](https://orb-ui.com/docs/reference/orb-component.md)
* [Themes and states](https://orb-ui.com/docs/themes/voice-states.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.