Ponder React SDK

Add ultra‑realistic voice agents to any React UI with Ponder.

Ponder lets users talk with your application just like they would with a human.

In one line of code, add ultra-realistic voice assistants that can interact with your UI and assist users in getting things done.

✨ Features

• One‑line provider – enable voice assistance on any page, plug and play ponder componenet, or build your own UI using the API
• Bring‑your‑own actions – expose any javascript function to the assistant
• Bring‑your‑own model – choose amongst all the popular llms or bring your own
• Real‑time VAD – built‑in voice activity detection, interruptions and streaming audio
• Natural speech playback – assistant responses are spoken in near real‑time (~700ms with gpt-4o)
• First‑class React hooks – usePonder for instantaneous updates
• Typescript ready – ships with .d.ts
• Supports React 16.8 → 19 (hooks!)

Installation

npm install @ponderai/react

Peer dependency – make sure react ≥ 16.8 is in your project.

Quick Start

First create an assistant on https://useponder.ai - pick a voice, model and provide base instructions that govern the knowledge and behaviour of the assistant. Then:

import { PonderProvider } from "@ponderai/react";

function App() {
  return (
    <PonderProvider
      assistantId="my‑assistant‑id"
      host="https://api.useponder.ai"   // or your self‑hosted server
    >
      <YourRoutes />
    </PonderProvider>
  );
}

The ponder widget now lives in the bottom‑right corner of the viewport. Click it to talk to the assistant.

Checkout docs at docs.useponder.ai