# Instalar paquetes Python

La **Import Package Window** te permite añadir dependencias de Python al mismo entorno que ejecuta:

* Designer Window custom blocks (`custom_blocks/*.py`)
* otros scripts de usuario que se ejecutan dentro de AugeLab Studio

## Primer vistazo <a href="#first-look" id="first-look"></a>

<figure><img src="https://1490675745-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F05D1CT7pajknL8HxF5RY%2Fuploads%2Fgit-blob-1fee5e6ceb2bfdea4e836dd5ce67abc38b79a3aa%2Fimport-package-window-first-look.jpg?alt=media" alt="Import Package Window"><figcaption><p>Import Package Window</p></figcaption></figure>

## Abrir la ventana <a href="#open-window" id="open-window"></a>

* Menú: `Tools > Import Package Window`

## Hoja de referencia rápida <a href="#quick-cheat-sheet" id="quick-cheat-sheet"></a>

| Quieres…                                             | Usar                                                  | Notas                                                                      |
| ---------------------------------------------------- | ----------------------------------------------------- | -------------------------------------------------------------------------- |
| Copiar un único archivo `.py` a Studio               | `IMPORT SCRIPT TO STUDIO`                             | Útil para pequeños helpers (p. ej., `utils.py`).                           |
| Copiar una carpeta local completa (paquete) a Studio | `IMPORT PACKAGE TO STUDIO`                            | Elige una carpeta que contenga módulos Python.                             |
| Instalar desde PyPI                                  | `INSTALL PACKAGE FROM PYPI` + `ADD PACKAGE TO STUDIO` | Requiere Internet. Puedes introducir varios nombres (separados por comas). |
| Validar información de nombre/versión del paquete    | `CHECK PACKAGE INFO`                                  | Imprime metadatos en el panel de logs.                                     |
| Abrir la ayuda integrada                             | `Help` (menú superior en la ventana)                  | Abre “Import Python Package Manual”.                                       |

{% hint style="warning" %}
Instalar paquetes de terceros puede reducir la portabilidad. Si tu escenario necesita ejecutarse en otra máquina, instala los mismos paquetes allí también (misma versión de Python + plataforma).
{% endhint %}

<details>

<summary>Install from PyPI</summary>

1. Abre `Tools > Import Package Window`.
2. En **INSTALL PACKAGE FROM PYPI**, escribe uno o más nombres de paquetes (separados por comas).
3. Haz clic en **CHECK PACKAGE INFO** para confirmar que el paquete existe y revisar los metadatos.
4. Haz clic en **ADD PACKAGE TO STUDIO** y observa el log para ver el progreso/errores.

{% hint style="info" %}
Los paquetes se instalan en el directorio “pkgs” de Studio (el mismo entorno usado por los custom blocks de Designer).
{% endhint %}

</details>

<details>

<summary>Import a local script (.py)</summary>

1. Haz clic en **IMPORT SCRIPT TO STUDIO**.
2. Elige un archivo `.py`.
3. Confirma el mensaje de éxito.

Usa esto cuando quieras importar un módulo helper y luego hacer `import my_helper` desde tu custom block.

</details>

<details>

<summary>Import a local package (folder)</summary>

1. Haz clic en **IMPORT PACKAGE TO STUDIO**.
2. Elige una carpeta que contenga tu paquete/módulos Python.
3. Confirma el mensaje de éxito (o lee el diálogo de error).

{% hint style="info" %}
Si actualizas el paquete más tarde, vuelve a importarlo (o elimina la copia vieja primero y luego importa de nuevo).
{% endhint %}

</details>

<details>

<summary>Troubleshooting</summary>

| Problema                                | Qué intentar                                                                                  |
| --------------------------------------- | --------------------------------------------------------------------------------------------- |
| “Package not found”                     | Verifica el nombre en `pypi.org` y vuelve a intentar con **CHECK PACKAGE INFO**.              |
| La instalación falla a mitad de proceso | Comprueba tu conexión a Internet y revisa la salida del log.                                  |
| Un custom block falla al importar       | Envuelve las importaciones opcionales en `try/except ImportError` y maneja `None` en `run()`. |

</details>