# Inicio rápido

Esta sección explica cómo ejecutar AugeLab Studio **sin la interfaz de escritorio** mediante la clase pública de la API `studio.StudioScenario`.

Independientemente de tu plataforma, el runtime de AugeLab garantiza que todo funcione de la misma manera. { % endhint %}

## Inicio rápido

A continuación te mostramos un ejemplo rápido de cómo ejecutar un escenario en modo headless usando código Python.

Vamos a crear un escenario sencillo de cálculo y gestionarlo desde un script Python.

Abre la aplicación de escritorio AugeLab Studio y crea un nuevo escenario con los siguientes bloques:

<figure><img src="https://1490675745-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F05D1CT7pajknL8HxF5RY%2Fuploads%2Fgit-blob-69d09b08344ef4c01c460b59c44576ef685abfb7%2Fheadless-calculus-example.jpg?alt=media" alt="Headless Quick Start" width="600"><figcaption></figcaption></figure>

Ejemplo de cálculo en modo Headless

Guarda el escenario como `calculus_example.pmod`.

Crea un nuevo script Python con el siguiente código:

{% 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 %}

Sustituye `YOUR_CODE_HERE` por tu código de verificación real.

Debes usar el ejecutable de Python en el que esté instalado AugeLab Studio. Si usas entornos virtuales, asegúrate de activar el entorno correcto primero. { % endhint %}

Ejecuta el script así:

```bash
python headless_calculus.py
```

Al ejecutar esto deberías ver una salida similar a:

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

## Transferencia de archivos .pmod

Transferir archivos .pmod es bastante sencillo. Simplemente copia los .pmod creados en la aplicación de escritorio a tu entorno headless.

Si tu archivo .pmod usa recursos externos (por ejemplo, imágenes, modelos), antes de copiar asegúrate de mantener la siguiente estructura de carpetas:

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

Y guarda el escenario antes de transferir los archivos. Puedes comprobarlo fácilmente moviendo la carpeta `project` a otra ubicación y ejecutando el escenario allí.

Algunos bloques personalizados pueden requerir recursos adicionales o dependencias que también deban transferirse o instalarse en el entorno headless. Asegúrate de revisar la documentación de cualquier bloque personalizado que estés usando. { % endhint %}

## Resumen

Ya estás listo para ejecutar tus propios escenarios headless con AugeLab Studio. Explora los distintos bloques y funcionalidades disponibles en la aplicación de escritorio y utilízalos desde tus aplicaciones Python en modo headless.

Para más detalles sobre características avanzadas, continúa leyendo la documentación.