.. _api-config:

Module de Configuration (``mirza.config``)
===========================================

Le module ``mirza.config`` centralise l'intégralité de la configuration de la plateforme
via des **dataclasses Python typées** et immuables. Aucune variable d'environnement n'est
requise pour le fonctionnement nominal.

.. contents:: Sommaire
   :local:
   :depth: 1

----

Vue d'Ensemble
--------------

.. list-table:: Classes de configuration disponibles
   :widths: 30 70
   :header-rows: 1

   * - Classe
     - Domaine de configuration
   * - :class:`~mirza.config.AudioConfig`
     - Paramètres acoustiques, détection d'activité vocale (VAD neural), taux d'échantillonnage
   * - :class:`~mirza.config.SttConfig`
     - Moteur STT, transcription streaming locale et repli
   * - :class:`~mirza.config.LlmConfig`
     - Moteur LLM, quantification, Speculative Decoding MTP, APC, budget CoT
   * - :class:`~mirza.config.TtsConfig`
     - Moteur TTS, voix, débit, hauteur de voix
   * - :class:`~mirza.config.PromptConfig`
     - System Prompt, protocole ``<result>``, historique conversationnel
   * - :class:`~mirza.config.AppConfig`
     - Configuration globale agrégeant tous les sous-modules ci-dessus

----

Référence API Complète
-----------------------

.. automodule:: mirza.config
   :members:
   :undoc-members:
   :show-inheritance:

----

Exemple d'Utilisation
-----------------------

.. code-block:: python

   from mirza.config import AppConfig, LlmConfig

   # Configuration par défaut (production Apple M4)
   config = AppConfig()

   # Personnalisation du moteur LLM
   config.llm.enableSpeculative = False  # désactiver MTP
   config.llm.maxTokens = 256           # réponses plus courtes
   config.llm.reasoningBudget = 1024    # BrainBoost CoT 1024 tokens

   # Changement de configuration TTS
   config.tts.provider = "default"
   config.tts.voice = "fr_f"