> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trugen.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Voice-Only Mode

> Run an agent without rendering a face — a customizable audio visualizer replaces the avatar for voice-first experiences.

Not every agent needs a face. **Voice-Only Mode** turns off the Huma avatar renderer and replaces it with a lightweight audio visualizer — a decorative animation that pulses with the agent's speech. Use it for voice-first products, low-bandwidth environments, or when your brand is stronger than any face you could render.

## When to use it

* **Voice-first products** — IVR replacements, phone-like conversations, screen-off use
* **Low-bandwidth or metered networks** — the visualizer streams a tiny fraction of what avatar video does
* **Brand-forward experiences** — center your logo and color instead of a stock face
* **Mobile-web** — great for interactions where a full avatar would dominate a small screen
* **Latency-sensitive edge cases** — skipping avatar render removes \~50–100 ms from the pipeline

Voice-only mode uses the same STT / LLM / TTS pipeline as a video agent — only the render layer changes.

## Audio visualizer variants

Voice-only mode ships with six built-in visualizer styles. Each one animates in sync with the agent's speech.

| Variant  | Style                                 |
| -------- | ------------------------------------- |
| `aura`   | Soft glowing halo                     |
| `bar`    | Vertical audio-meter bars             |
| `grid`   | Grid of pulsing cells                 |
| `radial` | Concentric circles reacting to volume |
| `wave`   | Flowing horizontal waveform           |
| `earth`  | Rotating globe animation              |

Pick the one that fits your brand. All six use your chosen accent color.

## Customization

Voice-only mode gives you three visual levers:

| Setting                | Description                                                           |
| ---------------------- | --------------------------------------------------------------------- |
| **Visualizer variant** | Choose one of the six variants above                                  |
| **Accent color**       | The color the visualizer pulses in (hex)                              |
| **Custom background**  | Toggle a custom background scene instead of the default flat backdrop |
| **Company logo**       | Show your logo centered inside the visualizer                         |

All customization happens in the Studio's Avatar tab when Voice-Only Mode is toggled on. The values persist on the agent config and apply everywhere the agent is embedded.

## Enabling voice-only mode

In the Studio, open the **Avatar** tab and toggle **Voice-only mode** on. Pick a visualizer variant, set the accent color, and optionally add a company logo.

Voice-only is stored on the agent's avatar config — everywhere the agent is embedded (widget, iframe, LiveKit plugin) picks up the setting on the next session.

## Widget SDK support

The `@aiteammate/agent-widget` React component also accepts an internal `audioAvatarVariant` prop for one-off overrides at render time. It accepts the same six values (`"aura" | "bar" | "grid" | "radial" | "wave" | "earth"`).

For most cases, configure voice-only on the agent itself so every embed matches — don't override it per widget instance unless you have a specific reason to.

## Best practices

* **Match visualizer to your brand.** `aura` reads soft and premium; `bar` reads technical and precise; `earth` reads exploratory. Test a few.
* **Pick a bold accent color.** The visualizer is the entire UI while the agent speaks — a washed-out color feels flat.
* **Add your logo.** In voice-only mode there's no face to anchor the eye — the logo becomes the identity of the experience.
* **Test on mobile.** Voice-only shines on small screens. Verify your color and logo work at phone size.

## Next steps

<CardGroup cols={2}>
  <Card title="Voices" icon="microphone" href="/docs/agents/voices/overview">
    Pick a voice that suits your voice-only experience.
  </Card>

  <Card title="Widget Customization" icon="palette" href="/docs/integrations/widget-customization">
    Match widget theming to your voice-only accent color.
  </Card>
</CardGroup>