.. _mirza-home:

==========================================================================
Mirza — Voice & Agentic Platform — Documentation Technique
==========================================================================

.. image:: https://img.shields.io/badge/Python-3.12%2B-blue.svg
   :target: https://www.python.org/
   :alt: Python 3.12+

.. image:: https://img.shields.io/badge/MLX-Apple_Silicon-black.svg
   :target: https://github.com/ml-explore/mlx
   :alt: MLX Apple Silicon

.. image:: https://img.shields.io/badge/Local-100%25_On--Premise-brightgreen.svg
   :alt: 100% On-Premise

.. image:: https://img.shields.io/badge/License-MIT-green.svg
   :alt: MIT License

|

.. important::

   **Mirza** est un assistant vocal et agentique haute performance conçu pour **Apple Silicon**.
   
   * **Matériel de référence** : Apple Silicon (mémoire unifiée UMA)
   * **Time-To-First-Token (TTFT)** : ~115 à 450 ms (selon profil et cache APC)
   * **Débit LLM** : 28 à 39 tokens/seconde en local
   * **Transcription STT** : < 200 ms (streaming binaire local)
   * **Latence globale de coupure de parole** : < 450 ms

----

Présentation
------------

Mirza est un assistant vocal conversationnel à faible latence et orienté agent, optimisé pour l'architecture **Apple Silicon** (16 Go, 24 Go de mémoire unifiée ou plus). L'exécution par défaut est 100% locale sans dépendance cloud obligatoire.

.. figure:: architecture/mirza_hud_overview.png
   :alt: Interface client de Mirza sur mobile
   :align: center
   :width: 65%

   Interface client de Mirza : réacteur central réactif, indicateurs de télémétrie matérielle et constellation de satellites.

La plateforme intègre les composants temps réel suivants :

.. list-table:: Capacités de la plateforme (Mesures sur Apple Silicon)
   :widths: 30 70
   :header-rows: 1

   * - Composant
     - Description
   * - **STT** (Speech-to-Text)
     - Moteur STT streaming local temps réel — streaming binaire WebSocket Int16 16 kHz (< 200 ms)
   * - **LLM** (Modèle de langage)
     - Moteurs LLM locaux haute performance avec décodage spéculatif MTP et cache APC (TTFT ~115–350 ms, 28–39 tok/s), complétés par un routeur distant
   * - **CoT** (Raisonnement)
     - Chain-of-Thought configurable (0, 512, 1024, 2048, 4096 tokens)
   * - **Agent** (Outils)
     - Smolagents CodeAgent ReAct avec 6 outils locaux/web et protocole bi-canal ``<result>``
   * - **TTS** (Synthèse vocale)
     - Moteur TTS neural local souverain temps réel (repli cloud optionnel) — streaming audio en < 400 ms
   * - **Frontend**
     - React 18 + TypeScript + Vite — HUD Cyberpunk 60/120 FPS sur OffscreenCanvas Web Worker

----

.. toctree::
   :maxdepth: 1
   :caption: Démarrage Rapide

   quickstart
   doc_simplifiee
   acces_distant
   mobile_setup

.. toctree::
   :maxdepth: 2
   :caption: Architectures

   architecture/logique_fonctionnelle
   architecture/profils_et_configuration
   architecture/backend
   architecture/frontend
   architecture/benchmarks
   architecture/ingenierie_thermique
   architecture/tests_and_quality

.. toctree::
   :maxdepth: 2
   :caption: Référence API Python

   modules/config
   modules/core
   modules/audio
   modules/engine
   modules/pipeline
   modules/server
   modules/frontend
   modules/entrypoint

.. toctree::
   :maxdepth: 1
   :caption: Références

   changelog

----

Indices et Tableaux
===================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`