# AI Voice Input Button

Voice dictation button in the composer bar of a chat assistant.

- id: `ai-voice-input-button`
- Page: https://agentic-ui-kit.com/components/ai-voice-input-button
- Live preview: https://agentic-ui-kit.com/live/component/ai-voice-input-button

## Install

```bash
agentic-ui add ai-voice-input-button
npx shadcn@4.17.0 add @agentic-ui/ai-voice-input-button
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** push-to-talk, live-waveform, toggle-recording, microphone-permission-handling, keyboard-activation, recording-duration-limit, transcription-handoff
- **Intents:** communicate, create-edit, monitor-live
- **Suits domains:** ai-workspace, saas, devtools, notes, operations
- **Interaction:** press-and-hold, keyboard-navigation, click-to-action
- **Screen role:** communication
- **Density:** medium
- **Dark mode:** yes
- **Use it for:** voice dictation button in the composer bar of a chat assistant, capturing audio notes in a personal productivity application, voice command to trigger actions in an operations console
- **Avoid when:** playback of already recorded audio, which requires a player with a scrubber, forms without audio capture capability or a dictation alternative
- **Preserve when adapting:** push-to-talk-interaction-model, live-waveform-feedback, permission-and-error-states, keyboard-activation-and-cancel
- **Replace when adapting:** audio-capture-adapter, transcription-provider, status-copy
- **Adaptation effort:** low
- **Coupling:** low
- **Quality score:** 9.2/10
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **Uses primitives:** button, card
- **npm dependencies:** @agentic-ui/motion-voice-waveform, lucide-react
- **npm dependencies (registry):** lucide-react@0.577.0
- **Registry dependencies:** motion-voice-waveform