mcpField
T
tavus-cvi-quickstart

tavus-cvi-quickstart

github.com/tavus-engineeringAgent workflows966 installsUpdated 40w ago
Repository

About tavus-cvi-quickstart

tavus-cvi-quickstart is a skill for developers starting real-time AI video conversations with Tavus. It explains how to create personas and conversations through the API, including available pipeline modes and session controls.

Key features

  1. 01Start conversations through the API
  2. 02Create custom personas
  3. 03Choose replica and persona resources
  4. 04Configure conversation options
  5. 05End active conversations
  6. 06Select full, echo, or audio mode

Use cases

  1. 01Launch a video conversation with stock resources
  2. 02Set up a custom conversational persona
  3. 03Create a practice or demo call
  4. 04End a conversation through the API

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/tavus-engineering/tavus-skills --skill tavus-cvi-quickstart

After installing, type/tavus-cvi-quickstartin Claude Code to confirm it loaded.

Details

From the project README

Tavus CVI Quick Start

Get a real-time AI video conversation running in minutes.

Fastest Path: Use Stock Resources

curl -X POST https://tavusapi.com/v2/conversations \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "replica_id": "rfe12d8b9597",
    "persona_id": "pdced222244b"
  }'

Response:

{
  "conversation_id": "c123456",
  "conversation_url": "https://tavus.daily.co/c123456",
  "status": "active"
}

Open conversation_url in browser to join the call.

Stock Resources

Replicas (the visual avatar):

  • rfe12d8b9597 - Default
  • re8e740a42 - Nathan

Personas (behavior/personality):

  • pdced222244b - Default
  • p24293d6 - Celebrity DJ

Create Custom Persona + Conversation

Step 1: Create Persona
curl -X POST https://tavusapi.com/v2/personas \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "persona_name": "Sales Coach",
    "pipeline_mode": "full",
    "system_prompt": "You are a friendly sales coach helping reps practice cold calls. Ask probing questions and give constructive feedback.",
    "context": "Focus on B2B SaaS sales scenarios.",
    "default_replica_id": "rfe12d8b9597"
  }'

Response:

{
  "persona_id": "p123456",
  "persona_name": "Sales Coach"
}
Step 2: Start Conversation
curl -X POST https://tavusapi.com/v2/conversations \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "persona_id": "p123456",
    "conversation_name": "Practice Session"
  }'

Conversation Options

{
  "persona_id": "p123456",
  "replica_id": "rfe12d8b9597",
  "conversation_name": "Demo Call",
  "conversational_context": "User is interested in enterprise pricing.",
  "custom_greeting": "Hi! I'm excited to help you today.",
  "callback_url": "https://your-webhook.com/tavus",
  "properties": {
    "enable_recording": true,
    "max_duration": 600
  }
}

End Conversation

curl -X POST https://tavusapi.com/v2/conversations/{conversation_id}/end \
  -H "x-api-key: YOUR_API_KEY"

Key Concepts

ConceptWhat it is
ReplicaThe visual avatar (face, appearance)
PersonaBehavior, voice, LLM config, system prompt
ConversationA live WebRTC session combining replica + persona

Pipeline Modes

  • full - Complete CVI with perception, STT, LLM, TTS (recommended)
  • echo - Bypass LLM, replica speaks what you send directly
  • audio - Audio-only, no video

Latency

~600ms utterance-to-utterance response time with full pipeline.

Next Steps

  • tavus-cvi-persona - Deep dive on persona configuration
  • tavus-cvi-ui - React component integration
  • tavus-cvi-interactions - Control conversations programmatically
  • tavus-cvi-knowledge - Add knowledge base and memories

Comments

Markdown supported