> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/french/key-features/headless.md).

# Utilisation headless

Cette section explique comment exécuter AugeLab Studio sans l'interface de bureau via la classe d'API publique `studio.StudioScenario`.

{% hint style="info" %}
L'API Headless offre des gains de performance importants par rapport à l'interface de bureau, notamment lors d'exécutions sur des serveurs sans GPU. Elle permet également une intégration facile dans d'autres applications/services Python.
{% endhint %}

***

## Flux vers du code

Votre scénario programmé visuellement (fichiers `.pmod`) peut être exécuté en mode headless via du code Python :

<figure><img src="/files/FIDlVw7OPYHGWXXXqzAd" alt="Flows to Code" width="400"><figcaption><p>Flux vers du code</p></figcaption></figure>

```python
from studio import StudioScenario
scenario = StudioScenario(verification_code="YOUR_CODE_HERE")
scenario.load_scenario("your_scenario.pmod")

while True:
    try:
        scenario.run()
    except KeyboardInterrupt:
        break
scenario.cleanup()
```

Lancer les fichiers .pmod sauvegardés à l'aide de scripts Python vous apporte plusieurs avantages :

* Implémenter vos propres tableaux de bord et interfaces utilisateur
* Intégrer des scénarios dans des applications plus larges
* Se connecter au système de journalisation (logging) du runtime AugeLab
* Exécuter des scénarios dans des conteneurs Docker (CPU/CUDA)
* Traiter par lots plusieurs entrées
* Automatiser les exécutions et planifier des tâches

et bien d'autres !