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

# Gradbot

> Prototype voice agents quickly with Gradium APIs

Gradbot is Gradium's open-source framework for prototyping voice agents. It gives you the event loop for low-latency speech interactions: streaming audio, VAD, turn-taking, interruptions, tool calls, and OpenAI-compatible LLM orchestration.

<CardGroup cols={2}>
  <Card title="Gradbot" icon="arrow-up-right-from-square" href="https://gradium.ai/gradbot">
    Explore the Gradbot overview and live demos.
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/gradium-ai/gradbot">
    Fork the open-source Gradbot repository.
  </Card>
</CardGroup>

<Note>
  Gradbot is built for fast prototyping, demos, and experimentation. For production scenarios, use Gradium APIs directly or through mature agent integrations such as [Pipecat](/integrations/agent-frameworks/pipecat).
</Note>

## Install

```bash theme={null}
pip install gradbot
```

## Basic agent

Create a `SessionConfig`, pick a Gradium voice, and let Gradbot run the realtime voice loop.

```python theme={null}
import gradbot

voice = gradbot.flagship_voice("Emma")

config = gradbot.SessionConfig(
    voice_id=voice.voice_id,
    instructions="You are a helpful assistant.",
    language=voice.language,
)

input_handle, output_handle = await gradbot.run(
    session_config=config,
    input_format=gradbot.AudioFormat.OggOpus,
    output_format=gradbot.AudioFormat.OggOpus,
)
```

## When to use Gradbot

* **Voice agent prototypes**: get from idea to a working spoken demo quickly.
* **Interactive demos**: showcase Gradium voices, interruptions, and tool calls in a browser.
* **Internal experiments**: test prompts, workflows, and voice UX before hardening the stack.
* **Hackathons and templates**: start with a small app instead of wiring every realtime primitive yourself.

## Production path

Once the interaction pattern is validated, move production workloads to Gradium's lower-level APIs or production-oriented integrations. [Pipecat](/integrations/agent-frameworks/pipecat) is a good fit when you need a mature pipeline framework for transports, processors, service composition, deployment, and observability.