Skip to main content

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 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.

Gradbot

Explore the Gradbot overview and live demos.

GitHub

Fork the open-source Gradbot repository.
Gradbot is built for fast prototyping, demos, and experimentation. For production scenarios, use Gradium APIs directly or through mature agent integrations such as Pipecat.

​
Install

pip install gradbot

​
Basic agent

Create a SessionConfig, pick a Gradium voice, and let Gradbot run the realtime voice loop. 
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 is a good fit when you need a mature pipeline framework for transports, processors, service composition, deployment, and observability.