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
| Prop | Type | Default | |
|---|---|---|---|
state | 'idle' | 'listening' | 'thinking' | 'speaking' | 'idle' | What the voice assistant is doing; each state has its own motion. |
level | AudioLevel | Audio 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. | |
stream | MediaStream | null | A live MediaStream (microphone, remote audio) analysed for the level instead of level. | |
size | number | 160 | Diameter in pixels. |
labels | Partial<VoiceOrbLabels> | Overrides for the built-in English text; keys left out keep their defaults. |
Related components
- Voice Input — Voice input with waveform and transcript
- AI Chat Window — AI chat window
- Chat Message — Messages with streaming output
- Message Branches — Message versions and a conversation branch tree
- Streaming Text — Smooth token streaming
- Markdown Preview — Rendered Markdown
- Response Feedback — Answer rating and a rubric for reviewers
- Prompt Composer — Prompt field with attachments
- Inline Suggestion — Inline autocomplete suggestion
- Model Selector — AI model picker
- Model Comparison — Side-by-side answers from several models
- Prompt Library — Prompt library with variables
Previous: Diff Review · Next: Voice Input · All AI chat and agents