# Installazione e accesso

> Index of the TerraLab docs for agents: [llms.txt](https://terra-lab.ai/docs/llms.txt). Every docs page is also served as markdown: add .md to its URL.

Installa un plugin TerraLab dal gestore dei plugin di QGIS, poi accedi una sola volta nel browser. Ci vuole circa un minuto e non serve carta.

## Requisiti

| Plugin | QGIS | Sistema |
| --- | --- | --- |
| AI Agent | 3.28 o successiva | Windows, macOS o Linux, con connessione a internet |
| AI Segmentation | 3.22 o successiva | Windows, macOS o Linux, con connessione a internet |
| AI Edit | 3.22 o successiva | Windows, macOS o Linux, con connessione a internet |

Nessuna GPU e nessun pacchetto Python da installare: i modelli girano sui server TerraLab.

## Installazione

1. In QGIS, apri **Plugins**, **Manage and Install Plugins**.
2. Cerca **AI Agent by TerraLab**, **AI Segmentation** o **AI Edit**.
3. Clicca **Install**.

Gli stessi plugin si possono scaricare come zip da plugins.qgis.org: [AI Agent](https://plugins.qgis.org/plugins/AI_Agent/), [AI Segmentation](https://plugins.qgis.org/plugins/AI_Segmentation/), [AI Edit](https://plugins.qgis.org/plugins/AI_Edit/). In QGIS, **Install from ZIP** installa quel file.

## Accesso

1. Apri il pannello del plugin. AI Agent si apre con `Ctrl+Alt+A`.
2. Clicca **Sign in**. Il browser apre terra-lab.ai.
3. Accedi o crea un account gratuito, conferma e torna a QGIS.

L'account si collega da solo e la quota gratuita compare nel pannello. Un solo account copre i tre plugin, il [server MCP](https://terra-lab.ai/it/docs/mcp) e l'API. Utilizzo e piani sono nella tua [dashboard](https://terra-lab.ai/it/dashboard).

## Aggiornamento

QGIS elenca gli aggiornamenti disponibili in **Plugins**, **Manage and Install Plugins**, **Upgradeable**. Installali da lì; l'accesso viene mantenuto.

## Quando qualcosa non va

- Un errore `DLL load failed` su Windows: vedi [DLL load failed while importing _C](https://terra-lab.ai/it/blog/dll-load-failed-while-importing-c-qgis).
- QGIS installato con Flatpak su Linux: vedi [No module named pip](https://terra-lab.ai/it/blog/qgis-flatpak-no-module-named-pip).
- Qualsiasi altro problema: scrivi al [supporto](https://terra-lab.ai/it/docs/support).

Source: https://terra-lab.ai/it/docs/plugins/install · Updated 2026-10-27