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

# Démarrage rapide

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

:::info Quelle que soit votre plateforme, le runtime AugeLab fonctionne de la même manière. :::

## Démarrage rapide

Nous allons vous guider à travers un exemple rapide d'exécution d'un scénario en mode headless avec du code Python.

Nous allons créer un simple scénario de calcul et le piloter depuis un script Python.

Ouvrez l'application de bureau AugeLab Studio et créez un nouveau scénario avec les blocs suivants :

<figure><img src="/files/xiOcNz7Nuxdfbaj8qsoE" alt="Headless Quick Start" width="600"><figcaption><p>Exemple de calcul en mode Headless</p></figcaption></figure>

Enregistrez le scénario sous `calculus_example.pmod`.

Créez un nouveau script Python nommé `headless_calculus.py` avec le code suivant :

`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()
```

Remplacez `YOUR_CODE_HERE` par votre code de vérification réel.

:::info Vous devez utiliser l'exécutable Python qui a AugeLab Studio installé. Si vous utilisez des environnements virtuels, assurez-vous d'activer l'environnement correct avant d'exécuter le script. :::

Exécutez le script :

```bash
python headless_calculus.py
```

L'exécution devrait produire quelque chose de similaire à :

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

## Transfert des fichiers .pmod

Le transfert des fichiers .pmod est simple. Vous pouvez copier les fichiers .pmod créés dans l'application de bureau vers votre environnement headless.

Si votre fichier .pmod utilise des ressources externes (par exemple des images ou des modèles), assurez-vous d'avoir la structure de dossier suivante avant de copier :

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

Et enregistrez le scénario avant de transférer les fichiers. Vous pouvez tester cela en déplaçant le dossier `project` vers un autre emplacement et en exécutant à nouveau le scénario là-bas.

:::info Certains blocs personnalisés peuvent nécessiter des ressources ou des dépendances supplémentaires à transférer ou à installer dans l'environnement headless. Vérifiez la documentation des blocs personnalisés que vous utilisez. :::

## Pour conclure

Vous êtes maintenant prêt à exécuter vos propres scénarios en mode headless avec AugeLab Studio ! Explorez les différents blocs et fonctionnalités disponibles dans l'application de bureau, puis exploitez-les depuis vos applications Python en headless.

Pour plus de détails sur les fonctionnalités avancées, poursuivez la lecture de la documentation.