> 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/hauptfunktionen/headless/headless-studio.md).

# Schnellstart (Headless)

Dieser Abschnitt beschreibt, wie Sie AugeLab Studio **ohne die Desktop-Benutzeroberfläche** über die öffentliche API-Klasse `studio.StudioScenario` ausführen.

Egal welches Betriebssystem Sie verwenden — die AugeLab-Runtime funktioniert überall gleich. { % endhint %}

## Schneller Start

Im Folgenden führen wir ein kurzes Beispiel zur Ausführung eines Headless-Szenarios mit Python-Code durch.

Wir erstellen ein einfaches "calculus" Szenario und steuern es per Python.

Öffnen Sie die AugeLab Studio Desktop-Anwendung und erstellen Sie ein neues Szenario mit den folgenden Blöcken:

<figure><img src="/files/LMYJ0Jh3p5tqXUqJ91Ty" alt="Headless Quick Start" width="600"><figcaption></figcaption></figure>

Headless Calculus Example

Speichern Sie das Szenario als `calculus_example.pmod`.

Erstellen Sie ein neues Python-Skript mit folgendem Code:

{% code title="headless\_calculus.py" %}

```python
from studio import StudioScenario
scenario = StudioScenario(verification_code="YOUR_CODE_HERE")
scenario.load_scenario("calculus_example.pmod")
for i in range(5):
    result = scenario.run((i,))
    print(f"Input: {i}, Output: {result[0]}")
scenario.cleanup()
```

{% endcode %}

Hinweis: Ersetzen Sie `YOUR_CODE_HERE` durch Ihren tatsächlichen Verifizierungscode.

Verwenden Sie das Python-Executable, in dem AugeLab Studio installiert ist. Wenn Sie virtuelle Umgebungen nutzen, aktivieren Sie zuerst die richtige Umgebung. { % endhint %}

Führen Sie das Skript aus mit:

```bash
python headless_calculus.py
```

Die Ausgabe sollte ähnlich aussehen wie:

```bash
... # studio initialization logs
1
2
3
4
5
```

## Übertragen von .pmod-Dateien

Das Übertragen von .pmod-Dateien ist unkompliziert. Kopieren Sie einfach die in der Desktop-Anwendung erstellten .pmod-Dateien in Ihre Headless-Umgebung.

Wenn Ihre .pmod-Datei externe Ressourcen verwendet (z. B. Bilder, Modelle), stellen Sie vor dem Kopieren sicher, dass Sie folgende Ordnerstruktur beibehalten:

```
\project
    scenario.pmod
    \resources
        template.jpg
        model.weights
        model.names
        model.cfg
        ...
```

Speichern Sie das Szenario vor dem Verschieben. Testen Sie es, indem Sie den gesamten `project`-Ordner an einen anderen Ort verschieben und das Szenario dort erneut ausführen.

Einige Custom Blocks benötigen zusätzliche Ressourcen oder Abhängigkeiten, die in der Headless-Umgebung installiert oder mitkopiert werden müssen. Prüfen Sie die Dokumentation der jeweiligen Custom Blocks. { % endhint %}

## Abschluss

Sie sind nun bereit, Headless-Szenarien mit AugeLab Studio auszuführen! Erkunden Sie die verschiedenen Blöcke und Funktionen in der Desktop-Anwendung und nutzen Sie sie in Ihren Headless-Python-Anwendungen.

Für weiterführende Informationen zu erweiterten Funktionen lesen Sie bitte weiter.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.augelab.com/german/hauptfunktionen/headless/headless-studio.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.