Installazione

Guida funziona su Windows 10/11 (x64). Richiede due dipendenze di esecuzione.

Prerequisiti

Runtime .NET 9

Guida è basato su .NET 9. Servono entrambi:

1. .NET Desktop Runtime 9.0 — per l’interfaccia WPF
2. ASP.NET Core Runtime 9.0 — per Hosted API, MCP, dashboard e superfici Remote Ops integrate

Scaricali entrambi da dotnet.microsoft.com/download/dotnet/9.0. Cerca la sezione “Runtime”.

Se manca uno dei due componenti, Windows ti chiederà di scaricarlo al primo avvio.

Runtime WebView2

Guida usa Microsoft Edge WebView2 come motore del browser. È preinstallato su Windows 10 (da aprile 2018 in poi) e Windows 11. Se non è presente:

Scaricalo da developer.microsoft.com/microsoft-edge/webview2.

Download

Guida ora offre due download per Windows:

• Scarica Guida Complete — consigliato per la maggior parte degli utenti. È l’app desktop completa con automazione del browser, MCP, scripting, code, strumenti per flussi di lavoro e interfaccia operatore.
• Scarica Guida Node — per esecuzione remota avanzata. Esegue automazione browser headed e processi di lavoro dello spazio di lavoro tramite la Remote Ops API.

La maggior parte degli utenti dovrebbe installare prima Guida Complete. Usa Guida Node quando vuoi esplicitamente un executor remoto/headed su un’altra macchina, un portatile, una rete privata collegata tramite VPS o un nodo di automazione.

È disponibile anche il pacchetto zip di Guida Node per estrazione manuale e test su NetBird/reti private.

È disponibile una Software Bill of Materials (SBOM) in formato CycloneDX.

Per approfondire, vedi Codice aperto e codice chiuso: la pagina spiega le ragioni della scelta di non pubblicare il codice sorgente di Guida e il ruolo del software open source nel progetto.

Avviso di Windows SmartScreen

Poiché Guida non dispone ancora di una firma digitale, Windows SmartScreen potrebbe mostrare un avviso la prima volta che lo esegui:

1. Fai clic su “Ulteriori informazioni”
2. Fai clic su “Esegui comunque”

Succede solo una volta. Per rimuovere l’avviso in modo permanente, fai clic con il tasto destro sul programma di installazione Guida Complete scaricato, apri Proprietà, seleziona “Sblocca” in fondo alla scheda Generale e poi fai clic su OK.

Primo avvio

1. Fai doppio clic sul programma di installazione Guida Complete
2. Completa le istruzioni del programma di installazione
3. Avvia Guida
4. La finestra del browser si apre con una scheda vuota
5. Naviga verso qualsiasi URL usando la barra degli indirizzi

Fatto. Ora puoi iniziare a scrivere script.

Facoltativo: Guida Node

Guida Node non è il punto di partenza normale per l’uso desktop. È un executor WebView2 headed per scenari di automazione remota:

• esegue processi di lavoro dello spazio di lavoro e code su una macchina remota;
• espone Remote Ops per controllo browser su canale fidato, telemetria, registro di tracciabilità, file dello spazio di lavoro, risultati catturati e recupero dei flussi di lavoro;
• mantiene una superficie browser headed locale, così l’automazione si comporta come una vera esecuzione browser WebView2.

Guida Node non include intenzionalmente l’interfaccia operatore desktop completa di Complete, MCP grezzo per impostazione predefinita o funzionalità locali esclusive di Complete come layout avanzati dei pannelli, voce locale, riconoscimento OCR e dialoghi interattivi per le credenziali di accesso. Usa Guida Complete quando vuoi l’esperienza completa dell’app; usa Node quando sai già di avere bisogno di esecuzione remota.

Facoltativo: configurazione IA

Per usare le funzionalità IA di Guida, serve un backend LLM locale:

• Ollama (consigliato) — installalo da ollama.com, poi scarica un modello: ollama pull llama3.2

Configura il backend IA in Impostazioni > Assistente IA (Settings > AI Assistant).