Voice Orb

Audio-reactive orb for voice mode whose blurred --chart and --primary color blobs orbit inside a glossy sphere and swell with a 0..1 level prop, easing between idle breathing, listening ripples, a circling thinking arc and churning speaking motion, with a simulate mode that synthesizes speech-like levels and a gentle opacity pulse under reduced motion; pairs with VoiceInput for capture.

Preview

Voice Orb preview width

Install

Add it with the shadcn CLI, or copy the source manually.

$ bunx --bun shadcn add @karaui/voice-orb
@karaui not found? Add it to components.json
{
  "registries": {
    "@karaui": "https://karaui.kamisama-v0.my.id/r/{name}.json"
  }
}

@karaui is in shadcn's public registry directory, so the latest CLI needs no setup. On an older CLI, merge this into the existing file once and every @karaui/… install resolves.

API Reference

state?
"idle" | "listening" | "thinking" | "speaking"
idle
level?
number

Audio amplitude 0..1 (mic input while listening, output while speaking).

0
simulate?
boolean

Synthesize a plausible `level` for the current state (no audio needed).

false
size?
number

Diameter in px. Default 160.

160
label?
string

Accessible name; the current state is appended. Default "Voice assistant".

Voice assistant
className?
string
—

Updated