Adding nextjs + 11labs + openai streaming demo (#139)

* adding nextjs + 11labs + openai streaming demo * removing package-lock
2026-02-04 17:39:23 +08:00 · 2025-03-08 00:54:23 +05:30
parent 4cac472ff4
commit 6905810f37
31 changed files with 1654 additions and 0 deletions
--- a/demo/nextjs_voice_chat/README.md
+++ b/demo/nextjs_voice_chat/README.md
@@ -0,0 +1,74 @@
+# FastRTC POC
+A simple POC for a fast real-time voice chat application using FastAPI and FastRTC by [rohanprichard](https://github.com/rohanprichard). I wanted to make one as an example with more production-ready languages, rather than just Gradio.
+
+## Setup
+1. Set your API keys in an `.env` file based on the `.env.example` file
+2. Create a virtual environment and install the dependencies
+    ```bash
+    python3 -m venv env
+    source env/bin/activate
+    pip install -r requirements.txt
+    ```
+
+3. Run the server
+    ```bash
+    ./run.sh
+    ```
+4. Navigate into the frontend directory in another terminal
+    ```bash
+    cd frontend/fastrtc-demo
+    ```
+5. Run the frontend
+    ```bash
+    npm install
+    npm run dev
+    ```
+6. Go to the URL and click the microphone icon to start chatting!
+
+7. Reset chats by clicking the trash button on the bottom right
+
+## Notes
+You can choose to not install the requirements for TTS and STT by removing the `[tts, stt]` from the specifier in the `requirements.txt` file.
+
+- The STT is currently using the ElevenLabs API.
+- The LLM is currently using the OpenAI API.
+- The TTS is currently using the ElevenLabs API.
+- The VAD is currently using the Silero VAD model.
+- You may need to install ffmpeg if you get errors in STT
+
+The prompt can be changed in the `backend/server.py` file and modified as you like.
+
+### Audio Parameters 
+
+#### AlgoOptions
+
+- **audio_chunk_duration**: Length of audio chunks in seconds. Smaller values allow for faster processing but may be less accurate.
+- **started_talking_threshold**: If a chunk has more than this many seconds of speech, the system considers that the user has started talking.
+- **speech_threshold**: After the user has started speaking, if a chunk has less than this many seconds of speech, the system considers that the user has paused.
+
+#### SileroVadOptions
+
+- **threshold**: Speech probability threshold (0.0-1.0). Values above this are considered speech. Higher values are more strict.
+- **min_speech_duration_ms**: Speech segments shorter than this (in milliseconds) are filtered out.
+- **min_silence_duration_ms**: The system waits for this duration of silence (in milliseconds) before considering speech to be finished.
+- **speech_pad_ms**: Padding added to both ends of detected speech segments to prevent cutting off words.
+- **max_speech_duration_s**: Maximum allowed duration for a speech segment in seconds. Prevents indefinite listening.
+
+### Tuning Recommendations
+
+- If the AI interrupts you too early:
+  - Increase `min_silence_duration_ms`
+  - Increase `speech_threshold`
+  - Increase `speech_pad_ms`
+
+- If the AI is slow to respond after you finish speaking:
+  - Decrease `min_silence_duration_ms`
+  - Decrease `speech_threshold`
+
+- If the system fails to detect some speech:
+  - Lower the `threshold` value
+  - Decrease `started_talking_threshold`
+
+
+## Credits:
+Credit for the UI components goes to Shadcn, Aceternity UI and Kokonut UI.
--- a/demo/nextjs_voice_chat/backend/env.py
+++ b/demo/nextjs_voice_chat/backend/env.py
@@ -0,0 +1,7 @@
+from dotenv import load_dotenv
+import os
+
+load_dotenv()
+
+LLM_API_KEY = os.getenv("LLM_API_KEY")
+ELEVENLABS_API_KEY = os.getenv("ELEVENLABS_API_KEY")
--- a/demo/nextjs_voice_chat/backend/server.py
+++ b/demo/nextjs_voice_chat/backend/server.py
@@ -0,0 +1,133 @@
+import fastapi
+from fastapi.responses import FileResponse
+from fastrtc import ReplyOnPause, Stream, AlgoOptions, SileroVadOptions
+from fastrtc.utils import audio_to_bytes
+from openai import OpenAI
+import logging
+import time
+from fastapi.middleware.cors import CORSMiddleware
+from elevenlabs import VoiceSettings, stream
+from elevenlabs.client import ElevenLabs
+import numpy as np
+import io
+
+from .env import LLM_API_KEY, ELEVENLABS_API_KEY
+
+
+sys_prompt = """
+You are a helpful assistant. You are witty, engaging and fun. You love being interactive with the user. 
+You also can add minimalistic utterances like 'uh-huh' or 'mm-hmm' to the conversation to make it more natural. However, only vocalization are allowed, no actions or other non-vocal sounds.
+Begin a conversation with a self-deprecating joke like 'I'm not sure if I'm ready for this...' or 'I bet you already regret clicking that button...'
+"""
+
+messages = [{"role": "system", "content": sys_prompt}]
+
+openai_client = OpenAI(
+    api_key=LLM_API_KEY
+)
+
+elevenlabs_client = ElevenLabs(api_key=ELEVENLABS_API_KEY)
+
+logging.basicConfig(level=logging.INFO)
+
+def echo(audio):
+
+    stt_time = time.time()
+
+    logging.info("Performing STT")
+
+    transcription = elevenlabs_client.speech_to_text.convert(
+        file=audio_to_bytes(audio),
+        model_id="scribe_v1",
+        tag_audio_events=False,
+        language_code="eng",
+        diarize=False,
+    )
+    prompt = transcription.text
+    if prompt == "":
+        logging.info("STT returned empty string")
+        return
+    logging.info(f"STT response: {prompt}")
+
+    messages.append({"role": "user", "content": prompt})
+
+    logging.info(f"STT took {time.time() - stt_time} seconds")
+
+    llm_time = time.time()
+    
+    def text_stream():
+        global full_response  
+        full_response = ""
+        
+        response = openai_client.chat.completions.create(
+            model="gpt-3.5-turbo",
+            messages=messages,
+            max_tokens=200,
+            stream=True
+        )
+        
+        for chunk in response:
+            if chunk.choices[0].finish_reason == "stop":
+                break
+            if chunk.choices[0].delta.content:
+                full_response += chunk.choices[0].delta.content
+                yield chunk.choices[0].delta.content
+
+    audio_stream = elevenlabs_client.generate(
+        text=text_stream(),
+        voice="Rachel",  # Cassidy is also really good
+        voice_settings=VoiceSettings(
+            similarity_boost=0.9,
+            stability=0.6,
+            style=0.4,
+            speed=1
+        ),
+        model="eleven_multilingual_v2",
+        output_format="pcm_24000",
+        stream=True
+    )
+
+    for audio_chunk in audio_stream:
+        audio_array = np.frombuffer(audio_chunk, dtype=np.int16).astype(np.float32) / 32768.0
+        yield (24000, audio_array)
+
+    messages.append({"role": "assistant", "content": full_response + " "})
+    logging.info(f"LLM response: {full_response}")
+    logging.info(f"LLM took {time.time() - llm_time} seconds")
+        
+
+stream = Stream(ReplyOnPause(echo,
+            algo_options=AlgoOptions(
+                audio_chunk_duration=0.5,
+                started_talking_threshold=0.1,
+                speech_threshold=0.03
+            ),
+            model_options=SileroVadOptions(
+                threshold=0.75,
+                min_speech_duration_ms=250,
+                min_silence_duration_ms=1500,
+                speech_pad_ms=400,
+                max_speech_duration_s=15
+            )), 
+            modality="audio", 
+            mode="send-receive"
+        )
+
+app = fastapi.FastAPI()
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+stream.mount(app)
+
+@app.get("/reset")
+async def reset():
+    global messages
+    logging.info("Resetting chat")
+    messages = [{"role": "system", "content": sys_prompt}]
+    return {"status": "success"}
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/.gitignore
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/.gitignore
@@ -0,0 +1,41 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/README.md
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/README.md
@@ -0,0 +1,36 @@
+This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+
+## Getting Started
+
+First, run the development server:
+
+```bash
+npm run dev
+# or
+yarn dev
+# or
+pnpm dev
+# or
+bun dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+
+This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+
+## Learn More
+
+To learn more about Next.js, take a look at the following resources:
+
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+
+You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+
+## Deploy on Vercel
+
+The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+
+Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/app/favicon.ico
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/app/favicon.ico
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/app/globals.css
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/app/globals.css
@@ -0,0 +1,130 @@
+@import "tailwindcss";
+
+@plugin "tailwindcss-animate";
+
+@custom-variant dark (&:is(.dark *));
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --font-sans: var(--font-geist-sans);
+  --font-mono: var(--font-geist-mono);
+  --color-sidebar-ring: var(--sidebar-ring);
+  --color-sidebar-border: var(--sidebar-border);
+  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
+  --color-sidebar-accent: var(--sidebar-accent);
+  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
+  --color-sidebar-primary: var(--sidebar-primary);
+  --color-sidebar-foreground: var(--sidebar-foreground);
+  --color-sidebar: var(--sidebar);
+  --color-chart-5: var(--chart-5);
+  --color-chart-4: var(--chart-4);
+  --color-chart-3: var(--chart-3);
+  --color-chart-2: var(--chart-2);
+  --color-chart-1: var(--chart-1);
+  --color-ring: var(--ring);
+  --color-input: var(--input);
+  --color-border: var(--border);
+  --color-destructive-foreground: var(--destructive-foreground);
+  --color-destructive: var(--destructive);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-accent: var(--accent);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-muted: var(--muted);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-secondary: var(--secondary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-primary: var(--primary);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-popover: var(--popover);
+  --color-card-foreground: var(--card-foreground);
+  --color-card: var(--card);
+  --radius-sm: calc(var(--radius) - 4px);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) + 4px);
+}
+
+:root {
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.129 0.042 264.695);
+  --card: oklch(1 0 0);
+  --card-foreground: oklch(0.129 0.042 264.695);
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.129 0.042 264.695);
+  --primary: oklch(0.208 0.042 265.755);
+  --primary-foreground: oklch(0.984 0.003 247.858);
+  --secondary: oklch(0.968 0.007 247.896);
+  --secondary-foreground: oklch(0.208 0.042 265.755);
+  --muted: oklch(0.968 0.007 247.896);
+  --muted-foreground: oklch(0.554 0.046 257.417);
+  --accent: oklch(0.968 0.007 247.896);
+  --accent-foreground: oklch(0.208 0.042 265.755);
+  --destructive: oklch(0.577 0.245 27.325);
+  --destructive-foreground: oklch(0.577 0.245 27.325);
+  --border: oklch(0.929 0.013 255.508);
+  --input: oklch(0.929 0.013 255.508);
+  --ring: oklch(0.704 0.04 256.788);
+  --chart-1: oklch(0.646 0.222 41.116);
+  --chart-2: oklch(0.6 0.118 184.704);
+  --chart-3: oklch(0.398 0.07 227.392);
+  --chart-4: oklch(0.828 0.189 84.429);
+  --chart-5: oklch(0.769 0.188 70.08);
+  --radius: 0.625rem;
+  --sidebar: oklch(0.984 0.003 247.858);
+  --sidebar-foreground: oklch(0.129 0.042 264.695);
+  --sidebar-primary: oklch(0.208 0.042 265.755);
+  --sidebar-primary-foreground: oklch(0.984 0.003 247.858);
+  --sidebar-accent: oklch(0.968 0.007 247.896);
+  --sidebar-accent-foreground: oklch(0.208 0.042 265.755);
+  --sidebar-border: oklch(0.929 0.013 255.508);
+  --sidebar-ring: oklch(0.704 0.04 256.788);
+}
+
+.dark {
+  --background: oklch(0.129 0.042 264.695);
+  --foreground: oklch(0.984 0.003 247.858);
+  --card: oklch(0.129 0.042 264.695);
+  --card-foreground: oklch(0.984 0.003 247.858);
+  --popover: oklch(0.129 0.042 264.695);
+  --popover-foreground: oklch(0.984 0.003 247.858);
+  --primary: oklch(0.984 0.003 247.858);
+  --primary-foreground: oklch(0.208 0.042 265.755);
+  --secondary: oklch(0.279 0.041 260.031);
+  --secondary-foreground: oklch(0.984 0.003 247.858);
+  --muted: oklch(0.279 0.041 260.031);
+  --muted-foreground: oklch(0.704 0.04 256.788);
+  --accent: oklch(0.279 0.041 260.031);
+  --accent-foreground: oklch(0.984 0.003 247.858);
+  --destructive: oklch(0.396 0.141 25.723);
+  --destructive-foreground: oklch(0.637 0.237 25.331);
+  --border: oklch(0.279 0.041 260.031);
+  --input: oklch(0.279 0.041 260.031);
+  --ring: oklch(0.446 0.043 257.281);
+  --chart-1: oklch(0.488 0.243 264.376);
+  --chart-2: oklch(0.696 0.17 162.48);
+  --chart-3: oklch(0.769 0.188 70.08);
+  --chart-4: oklch(0.627 0.265 303.9);
+  --chart-5: oklch(0.645 0.246 16.439);
+  --sidebar: oklch(0.208 0.042 265.755);
+  --sidebar-foreground: oklch(0.984 0.003 247.858);
+  --sidebar-primary: oklch(0.488 0.243 264.376);
+  --sidebar-primary-foreground: oklch(0.984 0.003 247.858);
+  --sidebar-accent: oklch(0.279 0.041 260.031);
+  --sidebar-accent-foreground: oklch(0.984 0.003 247.858);
+  --sidebar-border: oklch(0.279 0.041 260.031);
+  --sidebar-ring: oklch(0.446 0.043 257.281);
+}
+
+@layer base {
+  * {
+    @apply border-border outline-ring/50;
+  }
+  body {
+    @apply bg-background text-foreground;
+  }
+}
+
+.no-transitions * {
+  transition: none !important;
+}
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/app/layout.tsx
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/app/layout.tsx
@@ -0,0 +1,44 @@
+import type { Metadata } from "next";
+import { Geist, Geist_Mono } from "next/font/google";
+import "./globals.css";
+import { ThemeProvider } from "@/components/theme-provider";
+import { ThemeTransition } from "@/components/ui/theme-transition";
+
+const geistSans = Geist({
+  variable: "--font-geist-sans",
+  subsets: ["latin"],
+});
+
+const geistMono = Geist_Mono({
+  variable: "--font-geist-mono",
+  subsets: ["latin"],
+});
+
+export const metadata: Metadata = {
+  title: "FastRTC Demo",
+  description: "Interactive WebRTC demo with audio visualization",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en" suppressHydrationWarning>
+      <body
+        className={`${geistSans.variable} ${geistMono.variable} antialiased`}
+      >
+        <ThemeProvider
+          attribute="class"
+          defaultTheme="dark"
+          enableSystem
+          disableTransitionOnChange
+        >
+          {children}
+          <ThemeTransition />
+        </ThemeProvider>
+      </body>
+    </html>
+  );
+}
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/app/page.tsx
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/app/page.tsx
@@ -0,0 +1,16 @@
+import { BackgroundCircleProvider } from "@/components/background-circle-provider";
+import { ThemeToggle } from "@/components/ui/theme-toggle";
+import { ResetChat } from "@/components/ui/reset-chat";
+export default function Home() {
+  return (
+    <div className="flex flex-col items-center justify-center h-screen">
+      <BackgroundCircleProvider />
+      <div className="absolute top-4 right-4 z-10">
+        <ThemeToggle />
+      </div>
+      <div className="absolute bottom-4 right-4 z-10">
+        <ResetChat />
+      </div>
+    </div>
+  );
+}
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/components.json
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/components.json
@@ -0,0 +1,21 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "app/globals.css",
+    "baseColor": "slate",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "iconLibrary": "lucide"
+}
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/components/background-circle-provider.tsx
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/components/background-circle-provider.tsx
@@ -0,0 +1,123 @@
+"use client"
+
+import { useState, useEffect, useRef, useCallback } from "react";
+import { BackgroundCircles } from "@/components/ui/background-circles";
+import { AIVoiceInput } from "@/components/ui/ai-voice-input";
+import { WebRTCClient } from "@/lib/webrtc-client";
+
+export function BackgroundCircleProvider() {
+    const [currentVariant, setCurrentVariant] = 
+        useState<keyof typeof COLOR_VARIANTS>("octonary");
+    const [isConnected, setIsConnected] = useState(false);
+    const [webrtcClient, setWebrtcClient] = useState<WebRTCClient | null>(null);
+    const [audioLevel, setAudioLevel] = useState(0);
+    const audioRef = useRef<HTMLAudioElement>(null);
+
+    // Memoize callbacks to prevent recreation on each render
+    const handleConnected = useCallback(() => setIsConnected(true), []);
+    const handleDisconnected = useCallback(() => setIsConnected(false), []);
+    
+    const handleAudioStream = useCallback((stream: MediaStream) => {
+        if (audioRef.current) {
+            audioRef.current.srcObject = stream;
+        }
+    }, []);
+    
+    const handleAudioLevel = useCallback((level: number) => {
+        // Apply some smoothing to the audio level
+        setAudioLevel(prev => prev * 0.7 + level * 0.3);
+    }, []);
+
+    // Get all available variants
+    const variants = Object.keys(
+        COLOR_VARIANTS
+    ) as (keyof typeof COLOR_VARIANTS)[];
+
+    // Function to change to the next color variant
+    const changeVariant = () => {
+        const currentIndex = variants.indexOf(currentVariant);
+        const nextVariant = variants[(currentIndex + 1) % variants.length];
+        setCurrentVariant(nextVariant);
+    };
+
+    useEffect(() => {
+        // Initialize WebRTC client with memoized callbacks
+        const client = new WebRTCClient({
+            onConnected: handleConnected,
+            onDisconnected: handleDisconnected,
+            onAudioStream: handleAudioStream,
+            onAudioLevel: handleAudioLevel
+        });
+        setWebrtcClient(client);
+
+        return () => {
+            client.disconnect();
+        };
+    }, [handleConnected, handleDisconnected, handleAudioStream, handleAudioLevel]);
+
+    const handleStart = () => {
+        webrtcClient?.connect();
+    };
+
+    const handleStop = () => {
+        webrtcClient?.disconnect();
+    };
+
+    return (
+        <div 
+            className="relative w-full h-full"
+            onClick={changeVariant} // Add click handler to change color
+        >
+            <BackgroundCircles 
+                variant={currentVariant} 
+                audioLevel={audioLevel}
+                isActive={isConnected}
+            />
+            <div className="absolute inset-0 flex items-center justify-center">
+                <AIVoiceInput 
+                    onStart={handleStart}
+                    onStop={handleStop}
+                    isConnected={isConnected}
+                />
+            </div>
+            <audio ref={audioRef} autoPlay hidden />
+        </div>
+    );
+}
+
+export default { BackgroundCircleProvider }
+
+const COLOR_VARIANTS = {
+    primary: {
+        border: [
+            "border-emerald-500/60",
+            "border-cyan-400/50",
+            "border-slate-600/30",
+        ],
+        gradient: "from-emerald-500/30",
+    },
+    secondary: {
+        border: [
+            "border-violet-500/60",
+            "border-fuchsia-400/50",
+            "border-slate-600/30",
+        ],
+        gradient: "from-violet-500/30",
+    },
+    senary: {
+        border: [
+            "border-blue-500/60",
+            "border-sky-400/50",
+            "border-slate-600/30",
+        ],
+        gradient: "from-blue-500/30",
+    }, // blue
+    octonary: {
+        border: [
+            "border-red-500/60",
+            "border-rose-400/50",
+            "border-slate-600/30",
+        ],
+        gradient: "from-red-500/30",
+    },
+} as const;
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/components/theme-provider.tsx
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/components/theme-provider.tsx
@@ -0,0 +1,101 @@
+"use client";
+
+import { createContext, useContext, useEffect, useState } from "react";
+
+type Theme = "light" | "dark" | "system";
+
+type ThemeProviderProps = {
+  children: React.ReactNode;
+  defaultTheme?: Theme;
+  storageKey?: string;
+  attribute?: string;
+  enableSystem?: boolean;
+  disableTransitionOnChange?: boolean;
+};
+
+type ThemeProviderState = {
+  theme: Theme;
+  setTheme: (theme: Theme) => void;
+};
+
+const initialState: ThemeProviderState = {
+  theme: "system",
+  setTheme: () => null,
+};
+
+const ThemeProviderContext = createContext<ThemeProviderState>(initialState);
+
+export function ThemeProvider({
+  children,
+  defaultTheme = "system",
+  storageKey = "theme",
+  attribute = "class",
+  enableSystem = true,
+  disableTransitionOnChange = false,
+  ...props
+}: ThemeProviderProps) {
+  const [theme, setTheme] = useState<Theme>(defaultTheme);
+
+  useEffect(() => {
+    const savedTheme = localStorage.getItem(storageKey) as Theme | null;
+    
+    if (savedTheme) {
+      setTheme(savedTheme);
+    } else if (defaultTheme === "system" && enableSystem) {
+      const systemTheme = window.matchMedia("(prefers-color-scheme: dark)").matches
+        ? "dark"
+        : "light";
+      setTheme(systemTheme);
+    }
+  }, [defaultTheme, storageKey, enableSystem]);
+
+  useEffect(() => {
+    const root = window.document.documentElement;
+    
+    if (disableTransitionOnChange) {
+      root.classList.add("no-transitions");
+      
+      // Force a reflow
+      window.getComputedStyle(root).getPropertyValue("opacity");
+      
+      setTimeout(() => {
+        root.classList.remove("no-transitions");
+      }, 0);
+    }
+    
+    root.classList.remove("light", "dark");
+    
+    if (theme === "system" && enableSystem) {
+      const systemTheme = window.matchMedia("(prefers-color-scheme: dark)").matches
+        ? "dark"
+        : "light";
+      root.classList.add(systemTheme);
+    } else {
+      root.classList.add(theme);
+    }
+
+    localStorage.setItem(storageKey, theme);
+  }, [theme, storageKey, enableSystem, disableTransitionOnChange]);
+
+  const value = {
+    theme,
+    setTheme: (theme: Theme) => {
+      setTheme(theme);
+    },
+  };
+
+  return (
+    <ThemeProviderContext.Provider {...props} value={value}>
+      {children}
+    </ThemeProviderContext.Provider>
+  );
+}
+
+export const useTheme = () => {
+  const context = useContext(ThemeProviderContext);
+
+  if (context === undefined)
+    throw new Error("useTheme must be used within a ThemeProvider");
+
+  return context;
+};
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/components/ui/ai-voice-input.tsx
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/components/ui/ai-voice-input.tsx
@@ -0,0 +1,114 @@
+"use client";
+
+import { Mic, Square } from "lucide-react";
+import { useState, useEffect } from "react";
+import { cn } from "@/lib/utils";
+
+interface AIVoiceInputProps {
+  onStart?: () => void;
+  onStop?: (duration: number) => void;
+  isConnected?: boolean;
+  className?: string;
+}
+
+export function AIVoiceInput({
+  onStart,
+  onStop,
+  isConnected = false,
+  className
+}: AIVoiceInputProps) {
+  const [active, setActive] = useState(false);
+  const [time, setTime] = useState(0);
+  const [isClient, setIsClient] = useState(false);
+  const [status, setStatus] = useState<'disconnected' | 'connecting' | 'connected'>('disconnected');
+
+  useEffect(() => {
+    setIsClient(true);
+  }, []);
+
+  useEffect(() => {
+    let intervalId: NodeJS.Timeout;
+
+    if (active) {
+      intervalId = setInterval(() => {
+        setTime((t) => t + 1);
+      }, 1000);
+    } else {
+      setTime(0);
+    }
+
+    return () => clearInterval(intervalId);
+  }, [active]);
+
+  useEffect(() => {
+    if (isConnected) {
+      setStatus('connected');
+      setActive(true);
+    } else {
+      setStatus('disconnected');
+      setActive(false);
+    }
+  }, [isConnected]);
+
+  const formatTime = (seconds: number) => {
+    const mins = Math.floor(seconds / 60);
+    const secs = seconds % 60;
+    return `${mins.toString().padStart(2, "0")}:${secs.toString().padStart(2, "0")}`;
+  };
+
+  const handleStart = () => {
+    setStatus('connecting');
+    onStart?.();
+  };
+
+  const handleStop = () => {
+    onStop?.(time);
+    setStatus('disconnected');
+  };
+
+  return (
+    <div className={cn("w-full py-4", className)}>
+      <div className="relative max-w-xl w-full mx-auto flex items-center flex-col gap-4">
+        <div className={cn(
+          "px-2 py-1 rounded-md text-xs font-medium bg-black/10 dark:bg-white/10 text-gray-700 dark:text-white"
+        )}>
+          {status === 'connected' ? 'Connected' : status === 'connecting' ? 'Connecting...' : 'Disconnected'}
+        </div>
+
+        <button
+          className={cn(
+            "group w-16 h-16 rounded-xl flex items-center justify-center transition-colors",
+            active
+              ? "bg-red-500/20 hover:bg-red-500/30"
+              : "bg-black/10 hover:bg-black/20 dark:bg-white/10 dark:hover:bg-white/20"
+          )}
+          type="button"
+          onClick={active ? handleStop : handleStart}
+          disabled={status === 'connecting'}
+        >
+          {status === 'connecting' ? (
+            <div
+              className="w-6 h-6 rounded-sm animate-spin bg-black dark:bg-white cursor-pointer pointer-events-auto"
+              style={{ animationDuration: "3s" }}
+            />
+          ) : active ? (
+            <Square className="w-6 h-6 text-red-500" />
+          ) : (
+            <Mic className="w-6 h-6 text-black/70 dark:text-white/70" />
+          )}
+        </button>
+
+        <span
+          className={cn(
+            "font-mono text-sm transition-opacity duration-300",
+            active
+              ? "text-black/70 dark:text-white/70"
+              : "text-black/30 dark:text-white/30"
+          )}
+        >
+          {formatTime(time)}
+        </span>
+      </div>
+    </div>
+  );
+}
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/components/ui/background-circles.tsx
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/components/ui/background-circles.tsx
@@ -0,0 +1,309 @@
+"use client";
+
+import { motion } from "framer-motion";
+import clsx from "clsx";
+import { useState, useEffect } from "react";
+
+interface BackgroundCirclesProps {
+    title?: string;
+    description?: string;
+    className?: string;
+    variant?: keyof typeof COLOR_VARIANTS;
+    audioLevel?: number;
+    isActive?: boolean;
+}
+
+const COLOR_VARIANTS = {
+    primary: {
+        border: [
+            "border-emerald-500/60",
+            "border-cyan-400/50",
+            "border-slate-600/30",
+        ],
+        gradient: "from-emerald-500/30",
+    },
+    secondary: {
+        border: [
+            "border-violet-500/60",
+            "border-fuchsia-400/50",
+            "border-slate-600/30",
+        ],
+        gradient: "from-violet-500/30",
+    },
+    tertiary: {
+        border: [
+            "border-orange-500/60",
+            "border-yellow-400/50",
+            "border-slate-600/30",
+        ],
+        gradient: "from-orange-500/30",
+    },
+    quaternary: {
+        border: [
+            "border-purple-500/60",
+            "border-pink-400/50",
+            "border-slate-600/30",
+        ],
+        gradient: "from-purple-500/30",
+    },
+    quinary: {
+        border: [
+            "border-red-500/60",
+            "border-rose-400/50",
+            "border-slate-600/30",
+        ],
+        gradient: "from-red-500/30",
+    }, // red
+    senary: {
+        border: [
+            "border-blue-500/60",
+            "border-sky-400/50",
+            "border-slate-600/30",
+        ],
+        gradient: "from-blue-500/30",
+    }, // blue
+    septenary: {
+        border: [
+            "border-gray-500/60",
+            "border-gray-400/50",
+            "border-slate-600/30",
+        ],
+        gradient: "from-gray-500/30",
+    },
+    octonary: {
+        border: [
+            "border-red-500/60",
+            "border-rose-400/50",
+            "border-slate-600/30",
+        ],
+        gradient: "from-red-500/30",
+    },
+} as const;
+
+const AnimatedGrid = () => (
+    <motion.div
+        className="absolute inset-0 [mask-image:radial-gradient(ellipse_at_center,transparent_30%,black)]"
+        animate={{
+            backgroundPosition: ["0% 0%", "100% 100%"],
+        }}
+        transition={{
+            duration: 40,
+            repeat: Number.POSITIVE_INFINITY,
+            ease: "linear",
+        }}
+    >
+        <div className="h-full w-full [background-image:repeating-linear-gradient(100deg,#64748B_0%,#64748B_1px,transparent_1px,transparent_4%)] opacity-20" />
+    </motion.div>
+);
+
+export function BackgroundCircles({
+    title = "",
+    description = "",
+    className,
+    variant = "octonary",
+    audioLevel = 0,
+    isActive = false,
+}: BackgroundCirclesProps) {
+    const variantStyles = COLOR_VARIANTS[variant];
+    const [animationParams, setAnimationParams] = useState({
+        scale: 1,
+        duration: 5,
+        intensity: 0
+    });
+    const [isLoaded, setIsLoaded] = useState(false);
+    
+    // Initial page load animation
+    useEffect(() => {
+        // Small delay to ensure the black screen is visible first
+        const timer = setTimeout(() => {
+            setIsLoaded(true);
+        }, 300);
+        
+        return () => clearTimeout(timer);
+    }, []);
+    
+    // Update animation based on audio level
+    useEffect(() => {
+        if (isActive && audioLevel > 0) {
+            // Simple enhancement of audio level for more dramatic effect
+            const enhancedLevel = Math.min(1, audioLevel * 1.5);
+            
+            setAnimationParams({
+                scale: 1 + enhancedLevel * 0.3,
+                duration: Math.max(2, 5 - enhancedLevel * 3),
+                intensity: enhancedLevel
+            });
+        } else if (animationParams.intensity > 0) {
+            // Only reset if we need to (prevents unnecessary updates)
+            const timer = setTimeout(() => {
+                setAnimationParams({
+                    scale: 1,
+                    duration: 5,
+                    intensity: 0
+                });
+            }, 300);
+            
+            return () => clearTimeout(timer);
+        }
+    }, [audioLevel, isActive, animationParams.intensity]);
+    
+    return (
+        <>
+            {/* Initial black overlay that fades out */}
+            <motion.div 
+                className="fixed inset-0 bg-black z-50"
+                initial={{ opacity: 1 }}
+                animate={{ opacity: isLoaded ? 0 : 1 }}
+                transition={{ duration: 1.2, ease: "easeInOut" }}
+                style={{ pointerEvents: isLoaded ? "none" : "auto" }}
+            />
+            
+            <div
+                className={clsx(
+                    "relative flex h-screen w-full items-center justify-center overflow-hidden",
+                    "bg-white dark:bg-black/5",
+                    className
+                )}
+            >
+                <AnimatedGrid />
+                <motion.div 
+                    className="absolute h-[480px] w-[480px]"
+                    initial={{ opacity: 0, scale: 0.9 }}
+                    animate={{ 
+                        opacity: isLoaded ? 1 : 0,
+                        scale: isLoaded ? 1 : 0.9
+                    }}
+                    transition={{ 
+                        duration: 1.5, 
+                        delay: 0.3,
+                        ease: "easeOut" 
+                    }}
+                >
+                    {[0, 1, 2].map((i) => (
+                        <motion.div
+                            key={i}
+                            className={clsx(
+                                "absolute inset-0 rounded-full",
+                                "border-2 bg-gradient-to-br to-transparent",
+                                variantStyles.border[i],
+                                variantStyles.gradient
+                            )}
+                            animate={{
+                                rotate: 360,
+                                scale: [
+                                    1 + (i * 0.05), 
+                                    (1 + (i * 0.05)) * (1 + (isActive ? animationParams.intensity * 0.2 : 0.02)),
+                                    1 + (i * 0.05)
+                                ],
+                                opacity: [
+                                    0.7 + (i * 0.1),
+                                    0.8 + (i * 0.1) + (isActive ? animationParams.intensity * 0.2 : 0),
+                                    0.7 + (i * 0.1)
+                                ]
+                            }}
+                            transition={{
+                                duration: isActive ? animationParams.duration : 8 + (i * 2),
+                                repeat: Number.POSITIVE_INFINITY,
+                                ease: "easeInOut",
+                            }}
+                        >
+                            <div
+                                className={clsx(
+                                    "absolute inset-0 rounded-full mix-blend-screen",
+                                    `bg-[radial-gradient(ellipse_at_center,${variantStyles.gradient.replace(
+                                        "from-",
+                                        ""
+                                    )}/10%,transparent_70%)]`
+                                )}
+                            />
+                        </motion.div>
+                    ))}
+                </motion.div>
+
+                <div className="absolute inset-0 [mask-image:radial-gradient(90%_60%_at_50%_50%,#000_40%,transparent)]">
+                    <motion.div 
+                        className="absolute inset-0 bg-[radial-gradient(ellipse_at_center,#0F766E/30%,transparent_70%)] blur-[120px]"
+                        initial={{ opacity: 0 }}
+                        animate={{
+                            opacity: isLoaded ? 0.7 : 0,
+                            scale: [1, 1 + (isActive ? animationParams.intensity * 0.3 : 0.02), 1],
+                        }}
+                        transition={{
+                            opacity: { duration: 1.8, delay: 0.5 },
+                            scale: { 
+                                duration: isActive ? 2 : 12,
+                                repeat: Number.POSITIVE_INFINITY,
+                                ease: "easeInOut",
+                            }
+                        }}
+                    />
+                    <motion.div 
+                        className="absolute inset-0 bg-[radial-gradient(ellipse_at_center,#2DD4BF/15%,transparent)] blur-[80px]"
+                        initial={{ opacity: 0 }}
+                        animate={{
+                            opacity: isLoaded ? 1 : 0,
+                            scale: [1, 1 + (isActive ? animationParams.intensity * 0.4 : 0.03), 1]
+                        }}
+                        transition={{
+                            opacity: { duration: 2, delay: 0.7 },
+                            scale: { 
+                                duration: isActive ? 1.5 : 15,
+                                repeat: Number.POSITIVE_INFINITY,
+                                ease: "easeInOut",
+                            }
+                        }}
+                    />
+                    
+                    {/* Additional glow that appears only during high audio levels */}
+                    {isActive && animationParams.intensity > 0.4 && (
+                        <motion.div 
+                            className={`absolute inset-0 bg-[radial-gradient(ellipse_at_center,${variantStyles.gradient.replace("from-", "")}/20%,transparent_70%)] blur-[60px]`}
+                            initial={{ opacity: 0, scale: 0.8 }}
+                            animate={{
+                                opacity: [0, animationParams.intensity * 0.6, 0],
+                                scale: [0.8, 1.1, 0.8],
+                            }}
+                            transition={{
+                                duration: 0.8,
+                                repeat: Number.POSITIVE_INFINITY,
+                                ease: "easeInOut",
+                            }}
+                        />
+                    )}
+                </div>
+            </div>
+        </>
+    );
+}
+
+export function DemoCircles() {
+    const [currentVariant, setCurrentVariant] =
+        useState<keyof typeof COLOR_VARIANTS>("octonary");
+
+    const variants = Object.keys(
+        COLOR_VARIANTS
+    ) as (keyof typeof COLOR_VARIANTS)[];
+
+    function getNextVariant() {
+        const currentIndex = variants.indexOf(currentVariant);
+        const nextVariant = variants[(currentIndex + 1) % variants.length];
+        return nextVariant;
+    }
+
+    return (
+        <>
+            <BackgroundCircles variant={currentVariant} />
+            <div className="absolute top-12 right-12">
+                <button
+                    type="button"
+                    className="bg-slate-950 dark:bg-white text-white dark:text-slate-950 px-4 py-1 rounded-md z-10 text-sm font-medium"
+                    onClick={() => {
+                        setCurrentVariant(getNextVariant());
+                    }}
+                >
+                    Change Variant
+                </button>
+            </div>
+        </>
+    );
+}
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/components/ui/reset-chat.tsx
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/components/ui/reset-chat.tsx
@@ -0,0 +1,18 @@
+"use client"
+
+import { Trash } from "lucide-react"
+
+export function ResetChat() {
+    return (
+        <button
+            className="w-10 h-10 rounded-md flex items-center justify-center transition-colors relative overflow-hidden bg-black/10 hover:bg-black/20 dark:bg-white/10 dark:hover:bg-white/20"
+            aria-label="Reset chat"
+            onClick={() => fetch("http://localhost:8000/reset")}
+        >
+            <div className="relative z-10">
+                <Trash className="h-5 w-5 text-black/70 dark:text-white/70" />
+            </div>
+    </button>
+    )
+}
+
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/components/ui/theme-toggle.tsx
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/components/ui/theme-toggle.tsx
@@ -0,0 +1,61 @@
+"use client";
+
+import { useTheme } from "@/components/theme-provider";
+import { cn } from "@/lib/utils";
+import { Moon, Sun } from "lucide-react";
+import { useRef } from "react";
+
+interface ThemeToggleProps {
+  className?: string;
+}
+
+export function ThemeToggle({ className }: ThemeToggleProps) {
+  const { theme } = useTheme();
+  const buttonRef = useRef<HTMLButtonElement>(null);
+
+  const toggleTheme = () => {
+    // Instead of directly changing the theme, dispatch a custom event
+    const newTheme = theme === "light" ? "dark" : "light";
+    
+    // Dispatch custom event with the new theme
+    window.dispatchEvent(
+      new CustomEvent('themeToggleRequest', { 
+        detail: { theme: newTheme } 
+      })
+    );
+  };
+
+  return (
+    <button
+      ref={buttonRef}
+      onClick={toggleTheme}
+      className={cn(
+        "w-10 h-10 rounded-md flex items-center justify-center transition-colors relative overflow-hidden",
+        "bg-black/10 hover:bg-black/20 dark:bg-white/10 dark:hover:bg-white/20",
+        className
+      )}
+      aria-label="Toggle theme"
+    >
+      <div className="relative z-10">
+        {theme === "light" ? (
+          <Moon className="h-5 w-5 text-black/70" />
+        ) : (
+          <Sun className="h-5 w-5 text-white/70" />
+        )}
+      </div>
+      
+      {/* Small inner animation for the button itself */}
+      <div 
+        className={cn(
+          "absolute inset-0 transition-transform duration-500",
+          theme === "light" 
+            ? "bg-gradient-to-br from-blue-500/20 to-purple-500/20 translate-y-full" 
+            : "bg-gradient-to-br from-amber-500/20 to-orange-500/20 -translate-y-full"
+        )}
+        style={{
+          transitionTimingFunction: "cubic-bezier(0.22, 1, 0.36, 1)"
+        }}
+      />
+    </button>
+  );
+} 
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/components/ui/theme-transition.tsx
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/components/ui/theme-transition.tsx
@@ -0,0 +1,120 @@
+"use client";
+
+import { useTheme } from "@/components/theme-provider";
+import { useEffect, useState } from "react";
+import { motion, AnimatePresence } from "framer-motion";
+
+interface ThemeTransitionProps {
+  className?: string;
+}
+
+export function ThemeTransition({ className }: ThemeTransitionProps) {
+  const { theme, setTheme } = useTheme();
+  const [position, setPosition] = useState({ x: 0, y: 0 });
+  const [isAnimating, setIsAnimating] = useState(false);
+  const [pendingTheme, setPendingTheme] = useState<string | null>(null);
+  const [visualTheme, setVisualTheme] = useState<string | null>(theme);
+
+  // Track mouse/touch position for click events
+  useEffect(() => {
+    const handleMouseMove = (e: MouseEvent) => {
+      setPosition({ x: e.clientX, y: e.clientY });
+    };
+    
+    const handleTouchMove = (e: TouchEvent) => {
+      if (e.touches[0]) {
+        setPosition({ x: e.touches[0].clientX, y: e.touches[0].clientY });
+      }
+    };
+    
+    window.addEventListener("mousemove", handleMouseMove);
+    window.addEventListener("touchmove", handleTouchMove);
+    
+    return () => {
+      window.removeEventListener("mousemove", handleMouseMove);
+      window.removeEventListener("touchmove", handleTouchMove);
+    };
+  }, []);
+
+  // Listen for theme toggle requests
+  useEffect(() => {
+    // Custom event for theme toggle requests
+    const handleThemeToggle = (e: CustomEvent) => {
+      if (isAnimating) return; // Prevent multiple animations
+      
+      const newTheme = e.detail.theme;
+      if (newTheme === theme) return;
+      
+      // Store the pending theme but don't apply it yet
+      setPendingTheme(newTheme);
+      setIsAnimating(true);
+      
+      // The actual theme will be applied mid-animation
+    };
+
+    window.addEventListener('themeToggleRequest' as any, handleThemeToggle as EventListener);
+    
+    return () => {
+      window.removeEventListener('themeToggleRequest' as any, handleThemeToggle as EventListener);
+    };
+  }, [theme, isAnimating]);
+
+  // Apply the theme change mid-animation
+  useEffect(() => {
+    if (isAnimating && pendingTheme) {
+      // Set visual theme immediately for the animation
+      setVisualTheme(pendingTheme);
+      
+      // Apply the actual theme change after a delay (mid-animation)
+      const timer = setTimeout(() => {
+        setTheme(pendingTheme as any);
+      }, 400); // Half of the animation duration
+      
+      // End the animation after it completes
+      const endTimer = setTimeout(() => {
+        setIsAnimating(false);
+        setPendingTheme(null);
+      }, 1000); // Match with animation duration
+      
+      return () => {
+        clearTimeout(timer);
+        clearTimeout(endTimer);
+      };
+    }
+  }, [isAnimating, pendingTheme, setTheme]);
+
+  return (
+    <AnimatePresence>
+      {isAnimating && (
+        <motion.div
+          className="fixed inset-0 z-[9999] pointer-events-none"
+          initial={{ opacity: 0 }}
+          animate={{ opacity: 1 }}
+          exit={{ opacity: 0 }}
+          transition={{ duration: 0.3 }}
+        >
+          <motion.div
+            className={`absolute rounded-full ${visualTheme === 'dark' ? 'bg-slate-950' : 'bg-white'}`}
+            initial={{ 
+              width: 0, 
+              height: 0,
+              x: position.x,
+              y: position.y,
+              borderRadius: '100%' 
+            }}
+            animate={{ 
+              width: Math.max(window.innerWidth * 3, window.innerHeight * 3),
+              height: Math.max(window.innerWidth * 3, window.innerHeight * 3),
+              x: position.x - Math.max(window.innerWidth * 3, window.innerHeight * 3) / 2,
+              y: position.y - Math.max(window.innerWidth * 3, window.innerHeight * 3) / 2,
+            }}
+            transition={{ 
+              duration: 0.8,
+              ease: [0.22, 1, 0.36, 1]
+            }}
+          />
+        </motion.div>
+      )}
+    </AnimatePresence>
+  );
+} 
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/eslint.config.mjs
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/eslint.config.mjs
@@ -0,0 +1,28 @@
+import { dirname } from "path";
+import { fileURLToPath } from "url";
+import { FlatCompat } from "@eslint/eslintrc";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const compat = new FlatCompat({
+  baseDirectory: __dirname,
+});
+
+const eslintConfig = [
+  ...compat.extends("next/core-web-vitals", "next/typescript"),
+  {
+    rules: {
+      "no-unused-vars": "off",
+      "no-explicit-any": "off",
+      "no-console": "off",
+      "no-debugger": "off",
+      "eqeqeq": "off",
+      "curly": "off",
+      "quotes": "off",
+      "semi": "off",
+    },
+  },
+];
+
+export default eslintConfig;
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/lib/utils.ts
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/lib/utils.ts
@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from "clsx"
+import { twMerge } from "tailwind-merge"
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/lib/webrtc-client.ts
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/lib/webrtc-client.ts
@@ -0,0 +1,189 @@
+interface WebRTCClientOptions {
+    onConnected?: () => void;
+    onDisconnected?: () => void;
+    onMessage?: (message: any) => void;
+    onAudioStream?: (stream: MediaStream) => void;
+    onAudioLevel?: (level: number) => void;
+}
+
+export class WebRTCClient {
+    private peerConnection: RTCPeerConnection | null = null;
+    private mediaStream: MediaStream | null = null;
+    private dataChannel: RTCDataChannel | null = null;
+    private options: WebRTCClientOptions;
+    private audioContext: AudioContext | null = null;
+    private analyser: AnalyserNode | null = null;
+    private dataArray: Uint8Array | null = null;
+    private animationFrameId: number | null = null;
+
+    constructor(options: WebRTCClientOptions = {}) {
+        this.options = options;
+    }
+
+    async connect() {
+        try {
+            this.peerConnection = new RTCPeerConnection();
+            
+            // Get user media
+            try {
+                this.mediaStream = await navigator.mediaDevices.getUserMedia({
+                    audio: true
+                });
+            } catch (mediaError: any) {
+                console.error('Media error:', mediaError);
+                if (mediaError.name === 'NotAllowedError') {
+                    throw new Error('Microphone access denied. Please allow microphone access and try again.');
+                } else if (mediaError.name === 'NotFoundError') {
+                    throw new Error('No microphone detected. Please connect a microphone and try again.');
+                } else {
+                    throw mediaError;
+                }
+            }
+            
+            this.setupAudioAnalysis();
+            
+            this.mediaStream.getTracks().forEach(track => {
+                if (this.peerConnection) {
+                    this.peerConnection.addTrack(track, this.mediaStream!);
+                }
+            });
+            
+            this.peerConnection.addEventListener('track', (event) => {
+                if (this.options.onAudioStream) {
+                    this.options.onAudioStream(event.streams[0]);
+                }
+            });
+            
+            this.dataChannel = this.peerConnection.createDataChannel('text');
+            
+            this.dataChannel.addEventListener('message', (event) => {
+                try {
+                    const message = JSON.parse(event.data);
+                    console.log('Received message:', message);
+                    
+                    if (this.options.onMessage) {
+                        this.options.onMessage(message);
+                    }
+                } catch (error) {
+                    console.error('Error parsing message:', error);
+                }
+            });
+            
+            // Create and send offer
+            const offer = await this.peerConnection.createOffer();
+            await this.peerConnection.setLocalDescription(offer);
+            
+            // Use same-origin request to avoid CORS preflight
+            const response = await fetch('http://localhost:8000/webrtc/offer', {
+                method: 'POST',
+                headers: { 
+                    'Content-Type': 'application/json',
+                    'Accept': 'application/json'
+                },
+                mode: 'cors', // Explicitly set CORS mode
+                credentials: 'same-origin',
+                body: JSON.stringify({
+                    sdp: offer.sdp,
+                    type: offer.type,
+                    webrtc_id: Math.random().toString(36).substring(7)
+                })
+            });
+            
+            const serverResponse = await response.json();
+            await this.peerConnection.setRemoteDescription(serverResponse);
+            
+            if (this.options.onConnected) {
+                this.options.onConnected();
+            }
+        } catch (error) {
+            console.error('Error connecting:', error);
+            this.disconnect();
+            throw error;
+        }
+    }
+
+    private setupAudioAnalysis() {
+        if (!this.mediaStream) return;
+        
+        try {
+            this.audioContext = new AudioContext();
+            this.analyser = this.audioContext.createAnalyser();
+            this.analyser.fftSize = 256;
+            
+            const source = this.audioContext.createMediaStreamSource(this.mediaStream);
+            source.connect(this.analyser);
+            
+            const bufferLength = this.analyser.frequencyBinCount;
+            this.dataArray = new Uint8Array(bufferLength);
+            
+            this.startAnalysis();
+        } catch (error) {
+            console.error('Error setting up audio analysis:', error);
+        }
+    }
+
+    private startAnalysis() {
+        if (!this.analyser || !this.dataArray || !this.options.onAudioLevel) return;
+        
+        // Add throttling to prevent too many updates
+        let lastUpdateTime = 0;
+        const throttleInterval = 100; // Only update every 100ms
+        
+        const analyze = () => {
+            this.analyser!.getByteFrequencyData(this.dataArray!);
+            
+            const currentTime = Date.now();
+            // Only update if enough time has passed since last update
+            if (currentTime - lastUpdateTime > throttleInterval) {
+                // Calculate average volume level (0-1)
+                let sum = 0;
+                for (let i = 0; i < this.dataArray!.length; i++) {
+                    sum += this.dataArray![i];
+                }
+                const average = sum / this.dataArray!.length / 255;
+                
+                this.options.onAudioLevel!(average);
+                lastUpdateTime = currentTime;
+            }
+            
+            this.animationFrameId = requestAnimationFrame(analyze);
+        };
+        
+        this.animationFrameId = requestAnimationFrame(analyze);
+    }
+
+    private stopAnalysis() {
+        if (this.animationFrameId !== null) {
+            cancelAnimationFrame(this.animationFrameId);
+            this.animationFrameId = null;
+        }
+        
+        if (this.audioContext) {
+            this.audioContext.close();
+            this.audioContext = null;
+        }
+        
+        this.analyser = null;
+        this.dataArray = null;
+    }
+
+    disconnect() {
+        this.stopAnalysis();
+        
+        if (this.mediaStream) {
+            this.mediaStream.getTracks().forEach(track => track.stop());
+            this.mediaStream = null;
+        }
+        
+        if (this.peerConnection) {
+            this.peerConnection.close();
+            this.peerConnection = null;
+        }
+        
+        this.dataChannel = null;
+        
+        if (this.options.onDisconnected) {
+            this.options.onDisconnected();
+        }
+    }
+} 
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/next.config.ts
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/next.config.ts
@@ -0,0 +1,7 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  /* config options here */
+};
+
+export default nextConfig;
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/package.json
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/package.json
@@ -0,0 +1,33 @@
+{
+  "name": "fastrtc-demo",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev --turbopack",
+    "build": "next build --no-lint",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "framer-motion": "^12.4.10",
+    "lucide-react": "^0.477.0",
+    "next": "15.2.2-canary.1",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tailwind-merge": "^3.0.2",
+    "tailwindcss-animate": "^1.0.7"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3",
+    "@tailwindcss/postcss": "^4",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "15.2.2-canary.1",
+    "tailwindcss": "^4",
+    "typescript": "^5"
+  }
+}
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/postcss.config.mjs
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/postcss.config.mjs
@@ -0,0 +1,5 @@
+const config = {
+  plugins: ["@tailwindcss/postcss"],
+};
+
+export default config;
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/public/file.svg
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/public/file.svg
@@ -0,0 +1 @@
+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/public/globe.svg
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/public/globe.svg
@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/public/next.svg
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/public/next.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/public/vercel.svg
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/public/vercel.svg
@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/public/window.svg
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/public/window.svg
@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>
--- a/demo/nextjs_voice_chat/frontend/fastrtc-demo/tsconfig.json
+++ b/demo/nextjs_voice_chat/frontend/fastrtc-demo/tsconfig.json
@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}
--- a/demo/nextjs_voice_chat/requirements.txt
+++ b/demo/nextjs_voice_chat/requirements.txt
@@ -0,0 +1,5 @@
+openai
+fastapi
+python-dotenv
+elevenlabs
+fastrtc[vad, stt, tts]
--- a/demo/nextjs_voice_chat/run.sh
+++ b/demo/nextjs_voice_chat/run.sh
@@ -0,0 +1 @@
+uvicorn backend.server:app --host 0.0.0.0 --port 8000
				`@@ -0,0 +1 @@`
				`<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>`
				`@@ -0,0 +1 @@`
				<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>
				`@@ -0,0 +1 @@`
				<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>
				`@@ -0,0 +1 @@`
				`<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>`
				`@@ -0,0 +1 @@`
				`uvicorn backend.server:app --host 0.0.0.0 --port 8000`