Voxide SDK v1.0

Introduction to Voxide

Voxide is a capability-first Voice AI SDK designed specifically for React and Next.js applications. Instead of building complex backend conversational agents, Voxide allows you to expose your existing client-side JavaScript functions to a Gemini-powered Live AI.

Client-Side Architecture

Voxide executes tools directly in the browser. This means your AI has instant, authenticated access to your router, your local state (like shopping carts), and your user's current session token without complex proxy routing.

#Installation

Install the `@voxide/react` package via npm. It includes both the core logic client and the pre-built, drop-in chat widget UI.

bash

npm install @voxide/react@latest lucide-react framer-motion

#Initialization

To connect to your Web Assistant, instantiate the DoweitClient with your Publishable Key. You can find this key in the Voxide Dashboard under Project Settings.

typescript

import { DoweitClient, DoweitWidget } from "@voxide/react";
 
// Initialize the client
const ai = new DoweitClient({
  publicKey: "vox_pub_live_9a8b7c6d5e4f3g2h1i0j",
});

Security Notice

Your publishable key is safe to expose in your frontend code, but you must configure your Domain Whitelist in the Voxide Dashboard. Voxide uses strict CORS policies to reject WebSocket connections originating from unauthorized domains.

Next: Quick Start