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

> Prototypez rapidement des agents vocaux avec les API Gradium

Gradbot est le framework open source de Gradium pour prototyper des agents vocaux. Il vous fournit la boucle d'événements des interactions vocales à faible latence : audio en streaming, VAD, gestion des tours de parole, interruptions, appels d'outils et orchestration de LLM compatibles OpenAI.

<CardGroup cols={2}>
  <Card title="Gradbot" icon="arrow-up-right-from-square" href="https://gradium.ai/gradbot">
    Découvrez la présentation de Gradbot et ses démos en direct.
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/gradium-ai/gradbot">
    Forkez le dépôt open source de Gradbot.
  </Card>
</CardGroup>

<Note>
  Gradbot est conçu pour le prototypage rapide, les démos et l'expérimentation. En production, utilisez les API Gradium directement ou via des intégrations d'agents matures comme [Pipecat](/fr/integrations/agent-frameworks/pipecat).
</Note>

## Installation

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

## Agent de base

Créez une `SessionConfig`, choisissez une voix Gradium et laissez Gradbot exécuter la boucle vocale en temps réel.

```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,
)
```

## Quand utiliser Gradbot

* **Prototypes d'agents vocaux** : passez rapidement d'une idée à une démo vocale fonctionnelle.
* **Démos interactives** : mettez en valeur les voix Gradium, les interruptions et les appels d'outils dans un navigateur.
* **Expérimentations internes** : testez des prompts, des workflows et l'UX vocale avant de consolider votre stack.
* **Hackathons et templates** : partez d'une petite application au lieu de câbler vous-même chaque primitive temps réel.

## Passage en production

Une fois le modèle d'interaction validé, migrez les charges de production vers les API de plus bas niveau de Gradium ou vers des intégrations orientées production. [Pipecat](/fr/integrations/agent-frameworks/pipecat) est un bon choix lorsque vous avez besoin d'un framework de pipeline mature pour les transports, les processeurs, la composition de services, le déploiement et l'observabilité.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.