.. _api-entrypoint:

Point d'Entrée CLI (``mirza.entrypoint``)
==========================================

Le module ``mirza.entrypoint`` fournit le point d'entrée de l'application via ``main.py``
et un analyseur d'arguments CLI complet.

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

----

Options CLI
-----------

.. list-table:: Arguments de ligne de commande disponibles
   :widths: 25 15 60
   :header-rows: 1

   * - Argument
     - Type
     - Description
   * - ``--server``
     - flag
     - Lance le serveur WebSocket FastAPI + widget React
   * - ``--host HOST``
     - str
     - Adresse d'écoute (défaut : ``0.0.0.0`` pour réseau local LAN)
   * - ``--port PORT``
     - int
     - Port d'écoute (défaut : ``8765``)
   * - ``--ssl``
     - flag
     - Active TLS (utilise ``certs/cert.pem`` ou génère un auto-signé)
   * - ``--turns N``
     - int
     - Nombre de tours de conversation en mode console (défaut : 10)
   * - ``--benchmark``
     - flag
     - Affiche le diagnostic complet de mémoire unifiée Apple Silicon et quitte
   * - ``--purge``
     - flag
     - Purge les caches mémoire GPU Metal et quitte
   * - ``--agent``
     - flag
     - Active le mode agentique smolagents dès le démarrage
   * - ``--text-only``
     - flag
     - Démarre sans préchargement ASR et TTS (mode texte pur, économise ~1.1 Go de RAM)

----

Exemple de Démarrage
---------------------

.. code-block:: bash

   # Production HTTPS + TLS (port 8765)
   .venv/bin/python main.py --server --ssl

   # Mode console interactif rapide
   .venv/bin/python main.py --turns 5

   # Diagnostic mémoire UMA instantané
   .venv/bin/python main.py --benchmark

----

Référence API
--------------

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