Overview
Tavus CVI delivers AI-powered video conversations directly in your application. You can integrate it using:
Every flow below needs a join URL: call Create Conversation with a valid Authentication header and read the
conversation_url string from the response. Use that value wherever the samples use conversation_url (JavaScript) or YOUR_CONVERSATION_URL (string placeholders in HTML or query strings).
For a ready-made UI, create a deployment and add
<tavus-embed> or <tavus-widget> directly to your page. Do not use an iframe.For private rooms, create the conversation with
require_auth: true and pass
the returned meeting_token to Daily with join({ url: conversation_url, token: meeting_token }).Implementation Steps
- @tavus/cvi-ui (Component Library)
- Vanilla JavaScript
- Node.js + Express
- React + Daily (createCallObject)
This method provides a full-featured React component library. It offers pre-built, customizable components and hooks for embedding Tavus CVI in your app.
@tavus/cvi-ui is a CLI that copies React source files into your project. It is not a hosted widget: you import generated files from your app, wrap UI in CVIProvider, render Conversation with a Tavus conversation_url, and use generated server helpers to keep TAVUS_API_KEY off the client. For the complete reference and lifecycle example, see the component library overview, blocks, components, hooks, and server helpers.React component library (@tavus/cvi-ui)
The Tavus Conversational Video Interface (CVI) React component library provides a complete set of pre-built components and hooks for integrating AI-powered video conversations into your React applications. This library simplifies setting up Tavus in your codebase, allowing you to focus on your application’s core features.Key features include:- Pre-built video chat components
- Device management (camera, microphone, screen sharing)
- Real-time audio/video processing
- Customizable styling and theming
- TypeScript support with full type definitions
Quick Start
Prerequisites
Before getting started, ensure you have a React project set up.Alternatively, you can start from our example project: CVI UI Haircheck Conversation Example - this example already has the HairCheck and Conversation blocks set up.1. Initialize CVI in Your Project
- Creates a
cvi-components.jsonconfig file - Prompts for TypeScript preference
- Installs npm dependencies (@daily-co/daily-react, @daily-co/daily-js, jotai)
2. Add CVI Components
3. Wrap Your App with the CVI Provider
In your root directory (main.tsx or index.tsx):4. Add a Conversation Component
Learn how to create a conversation URL at https://docs.tavus.io/api-reference/conversations/create-conversation. To create a conversation URL from your app without exposing yourTAVUS_API_KEY in the browser, use the server helpers in Server (tavus-api for Next.js/Remix/TanStack Start, or tavus-api-vite-ssr for Vite-with-server).Note: The Conversation component requires a parent container with defined dimensions to display properly.Ensure your body element has full dimensions (
width: 100% and height: 100%) in your CSS for proper component display.Documentation Sections
- Overview – Overview of the CVI component library
- Blocks – High-level component compositions and layouts
- Components – Individual UI components
- Hooks – Custom React hooks for managing video call state and interactions
- Server – Server-side helpers (
tavus-api,tavus-api-vite-ssr) for creating and ending conversations without exposing your API key
FAQs
How can I reduce background noise during calls?
How can I reduce background noise during calls?
Use
sparrow-2, the default turn detection model, which analyzes the full audio stream and uses background sound as context instead of requiring noise to be stripped away before turn detection. This improves turn-taking in loud and shared environments.If you need further isolation, we recommend trying the audiovisual voice isolation settings (beta), which use a combination of video and audio to decide whose voice to answer. They help with background noise as well as other people’s voices.Can I add event listeners to the call client?
Can I add event listeners to the call client?
Yes, you can attach Daily event listeners to monitor and respond to events like participants joining, leaving, or starting screen share.

