ValyroUI Русская версия

Voice Orb

Animated voice-mode orb. Pro · AI chat and agents › Voice

The animated orb of a voice mode (ChatGPT / Siri style). It breathes while idle, follows the audio level while listening or speaking and swirls while thinking. With reduced motion it stays still and shows the level as a soft glow.

Installation

npx valyro-cli@latest login
npx valyro-cli@latest add voice-orb
npm install valyro-ui-pro

import 'valyro-ui-pro/styles.css';
import { VoiceOrb } from 'valyro-ui-pro';

Props

PropTypeDefault
state'idle' | 'listening' | 'thinking' | 'speaking''idle'What the voice assistant is doing; each state has its own motion.
levelAudioLevelAudio level, 0–1, the orb reacts to while listening or speaking. A function is polled every frame (no re-render per sample), e.g. a meter over your text-to-speech output.
streamMediaStream | nullA live MediaStream (microphone, remote audio) analysed for the level instead of level.
sizenumber160Diameter in pixels.
labelsPartial<VoiceOrbLabels>Overrides for the built-in English text; keys left out keep their defaults.

Related components

Previous: Diff Review · Next: Voice Input · All AI chat and agents