# Voice

> Speak your requests to the agent, or talk with it and hear its answers. Speech goes to ElevenLabs, on Credits or with your own ElevenLabs key.

Source: https://graspable.dev/docs/voice

You can speak to the agent in three ways: say a request instead of typing it, hold a conversation in which the agent answers aloud, or talk with it from inside VR or AR.

## Before you start

Voice needs one of two things, chosen under **Settings, Voice**:

- your Graspable account, signed in. Voice then runs on Credits, with free minutes every day; or
- your own ElevenLabs API key.

[Who turns speech into text](#who-turns-speech-into-text) says what each costs.

## Speaking a request

Press the microphone beside the prompt, say what you want, and press it again (or Enter). What you said appears in the prompt, where you can change it before you send it. Escape drops the recording.

Graspable listens only between the two presses. The first time, your computer asks whether Graspable may use the microphone. One recording holds a few minutes of speech; for a longer request, speak it in parts.

## Talking with the agent

The button with the sound waves, under the microphone, starts a conversation. The microphone then stays open:

- Say what you want. When you stop speaking, what you said is sent: as a new request, or, while the agent is working, as a note that steers it.
- The agent answers in a few short sentences, and they are read aloud. A request you speak asks the agent to answer this way. Code and tables are left out of what is read; they stay in the run panel.
- Speak while it reads and the reading stops, so you can interrupt it.
- When the agent needs your OK for a step, it says so. Approve or decline on the screen.

Press the button again, or the cross beside "Listening", to end the conversation and close the microphone. To keep the answers silent, turn off **Read the agent's answers aloud** under **Settings, Voice**.

Every agent message also has a **Read aloud** button beside Copy.

## Talking in the headset

You can also talk with the agent while you are in VR or AR, in a web project.

- **In the preview on this computer** (the emulated headset), a **Talk to the agent** button sits low in front of you. Pressing it starts the same conversation as the button beside the prompt, with this computer's microphone.
- **On a real headset**, open **Headset**, share the preview on Wi-Fi, and choose **Talk in the headset**. Scan the new code with the headset. In VR or AR, press **Talk to the agent** and speak. The headset listens with its own microphone, and the agent's answers play in the headset. The conversation also shows in the app on your computer, where you approve steps.

The headset sends its recordings to Graspable on your computer, which turns them into text the same way as above. The headset never holds your ElevenLabs key or your Graspable sign-in. Choose **Stop talking in the headset**, or stop sharing, to end it.

## Who turns speech into text

ElevenLabs turns speech into text, and the agent's answers into speech. Choose how under **Settings, Voice**:

- **Graspable, on Credits.** Needs your Graspable account. About ten minutes of speech every day are free. Beyond them, voice uses [Credits](https://graspable.dev/docs/credits.md) by what it cost: about a third of a Credit for ten more minutes of speaking, and about a Credit for a page of answers read aloud.
- **ElevenLabs, with your own key.** ElevenLabs bills your own account. The key stays in your computer's keychain and is sent only to ElevenLabs.

Either way, the recording goes from the app to the agent on your computer, and from there to ElevenLabs (directly with your own key, or through Graspable). Graspable keeps no recording and no text of what you said, only how many seconds were turned into text and how many characters were read aloud that day.

## Language

Speech to text finds the language by itself. If it guesses wrong, for example with short requests, choose the language you speak under **Settings, Voice**.

## The agent's voice

Under **Settings, Voice** you also choose the voice the agent answers with, and **Hear it** plays a sample. On Credits the choice is ElevenLabs' own voices. With your own key it is every voice in your ElevenLabs account, including voices you made there.

## If something does not work

The app says what went wrong beside the prompt, for example that it may not use the microphone or that none was found. [Troubleshooting](https://graspable.dev/docs/troubleshooting.md) lists each message and what to do.
