Iseer Live API — Example Application

A real-time voice AI demo built with the Iseer Live API. Talk to the Arete-Live model using your microphone and hear it respond with ultra-low latency native audio.

---

Features

• 🎙️ Real-time Speech-to-Speech — Stream microphone audio directly to Arete-Live and hear responses instantly
• 🔊 Native Audio Output — 24kHz PCM playback with seamless buffering
• 💬 Live Transcriptions — See what you said and what the model said in real-time
• 🛑 Interruption Handling — Interrupt the model mid-sentence naturally, just like a real conversation
• 🎨 Glassmorphic UI — Modern dark-mode interface with animated voice orb visualizer
• 🐛 Built-in Debug Console — Copiable error logs displayed directly in the UI

---

Quick Start

Prerequisites

• Node.js 18+
• An Iseer API Key (iseer_live_...) — contact developer@iseer.co

Install & Run

git clone https://github.com/GodelEsherBach/iseer-live-api-example.git
cd iseer-live-api-example
npm install
npm run dev

Open http://localhost:5173 in your browser, click Connect, and start talking.

Configuration

Update the API key and WebSocket URL in src/live-client.js:

const wsUrl = 'wss://genai.api.iseer.co?key=iseer_live_YOUR_API_KEY';

---

Project Structure

├── index.html                  # App shell
├── public/
│   └── audio-processor.js      # AudioWorklet for 16kHz PCM capture
├── src/
│   ├── live-client.js           # WebSocket client for the Iseer Live API
│   ├── audio-manager.js         # Mic capture (16kHz) & PCM playback (24kHz)
│   ├── main.js                  # UI logic, event handling, debug console
│   └── style.css                # Glassmorphic dark-mode styles
└── package.json

---

How It Works

1. Connect — Opens a WebSocket to wss://genai.api.iseer.co with your API key
2. Setup — Sends a setup message specifying models/arete-live with audio response modality
3. Stream Audio — Captures microphone at 16kHz, chunks into ~100ms segments, and streams as base64 PCM
4. Receive Audio — Decodes incoming 24kHz PCM audio chunks and schedules them for gapless playback
5. Handle Events — Processes interruptions, transcriptions, turn completions, and errors

---

API Reference

For the full Iseer Live API documentation, see the Complete Reference.

Key Endpoints

Endpoint	Description
wss://genai.api.iseer.co	WebSocket endpoint for real-time sessions
POST https://api.iseer.co/api/live-connect	Provisioning API for ephemeral tokens

Authentication

Pass your API key as a query parameter or Authorization: Bearer header:

wss://genai.api.iseer.co?key=iseer_live_YOUR_API_KEY

---

Tech Stack

• Vite — Dev server & build tool
• Vanilla JS — Zero framework dependencies
• Web Audio API — AudioWorklet for low-latency mic capture & playback
• WebSockets — Direct connection to the Iseer Live API

---

License

MIT — see LICENSE for details.

---

Need help? Contact developer@iseer.co for support.