> 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/german/wichtige-funktionen/headless.md).

# Headless Nutzung

Dieser Abschnitt behandelt das Ausführen von AugeLab Studio ohne die Desktop-Benutzeroberfläche mithilfe der öffentlichen API-Klasse `studio.StudioScenario`.

{% hint style="info" %}
Die Headless-API bietet erhebliche Leistungssteigerungen im Vergleich zur Desktop-Oberfläche, insbesondere beim Betrieb auf Servern ohne GPU. Sie ermöglicht außerdem eine einfache Integration in andere Python-Anwendungen/-dienste.
{% endhint %}

***

## Von Flows zu Code

Visuell programmierte Szenarien (.pmod-Dateien) können headless über Python-Code ausgeführt werden:

<figure><img src="https://3159336763-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyMCLCvWBn7aHYpYmuuan%2Fuploads%2Fgit-blob-0cb916bce17f2fa3ab23af352a43db1eaa9fe4f2%2Fexample-scenario.jpg?alt=media" alt="Von Flows zu Code" width="400"><figcaption><p>Von Flows zu 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()
```

Das Ausführen der gespeicherten .pmod-Dateien mit Python-Skripten bietet mehrere Vorteile:

* Eigene Dashboards und UIs implementieren
* Szenarien in größere Anwendungen integrieren
* An das Logging-System der AugeLab-Runtime anbinden
* Szenarien in Docker-Containern ausführen (CPU/CUDA)
* Stapelverarbeitung mehrerer Eingaben
* Läufe automatisieren und planen

und vieles mehr!