Installation

Guida fonctionne sous Windows 10/11 (x64). Il nécessite deux dépendances d’exécution.

Prérequis

Runtime .NET 9

Guida est construit sur .NET 9. Vous avez besoin des deux composants suivants :

1. .NET Desktop Runtime 9.0 — pour l’interface WPF
2. ASP.NET Core Runtime 9.0 — pour Hosted API, MCP, le tableau de bord et les surfaces Remote Ops intégrés

Téléchargez-les depuis dotnet.microsoft.com/download/dotnet/9.0. Cherchez la section “Runtime”.

S’il manque l’un des deux runtimes, Windows vous proposera de le télécharger au premier lancement.

Runtime WebView2

Guida utilise Microsoft Edge WebView2 comme moteur de navigateur. Il est préinstallé sur Windows 10 (avril 2018 ou plus récent) et Windows 11. Si vous ne l’avez pas :

Téléchargez-le depuis developer.microsoft.com/microsoft-edge/webview2.

Téléchargement

Guida propose désormais deux téléchargements Windows :

• Télécharger Guida Complete — recommandé pour la plupart des utilisateurs. C’est l’app desktop complète avec automatisation du navigateur, MCP, scripting, files, outils de workflow et interface opérateur.
• Télécharger Guida Node — pour l’exécution distante avancée. Il exécute l’automatisation headed du navigateur et les processus de travail d’espace de travail via l’API Remote Ops.

La plupart des utilisateurs devraient installer Guida Complete en premier. Utilisez Guida Node lorsque vous voulez précisément un exécuteur distant/headed sur une autre machine, un ordinateur portable, un réseau privé relié par VPS ou un nœud d’automatisation.

Le paquet zip Guida Node est aussi disponible pour l'extraction manuelle et les tests NetBird/réseau privé.

Une nomenclature logicielle (SBOM) est disponible au format CycloneDX.

Pour comprendre ce qui est fermé, ce qui est déjà public et ce qui sera ouvert une fois extrait et stabilisé, consultez Code source ouvert et code source fermé.

Avertissement Windows SmartScreen

Comme Guida n’est pas encore signé numériquement, Windows SmartScreen peut afficher un avertissement au premier lancement :

1. Cliquez sur “More info”
2. Cliquez sur “Run anyway”

Cela ne se produit qu’une fois. Pour supprimer durablement l’avertissement, faites un clic droit sur l’installateur Guida Complete téléchargé, ouvrez Properties, cochez “Unblock” en bas de l’onglet General, puis cliquez sur OK.

Premier lancement

1. Double-cliquez sur l’installateur Guida Complete
2. Terminez les étapes de l’installateur
3. Lancez Guida
4. La fenêtre du navigateur s’ouvre avec un onglet vide
5. Accédez à n’importe quelle URL avec la barre d’adresse

C’est tout. Vous pouvez commencer à écrire des scripts.

Facultatif: Guida Node

Guida Node n’est pas le point de départ normal pour l’usage desktop. C’est un exécuteur WebView2 headed pour les scénarios d’automatisation distante :

• exécuter les processus de travail d’espace de travail et les files sur une machine distante ;
• exposer Remote Ops pour le contrôle du navigateur sur canal de confiance, la télémétrie, le registre de traçabilité, les fichiers d’espace de travail, les résultats capturés et la récupération des workflows ;
• conserver une surface de navigateur headed locale afin que l’automatisation se comporte comme une vraie exécution de navigateur WebView2.

Guida Node n’inclut volontairement pas l’interface opérateur desktop complète de Complete, MCP brut par défaut, ni les fonctions locales réservées à Complete comme les mises en page riches de panneaux, la voix locale, la reconnaissance OCR et les dialogues interactifs d’identifiants d’accès. Utilisez Guida Complete pour l’expérience complète de l’app ; utilisez Node lorsque vous savez déjà que vous avez besoin d’exécution distante.

Facultatif : configuration IA

Pour utiliser les fonctions IA de Guida, vous avez besoin d’un backend LLM local :

• Ollama (recommandé) — installez-le depuis ollama.com, puis téléchargez un modèle : ollama pull llama3.2

Configurez le backend IA dans Settings > AI Assistant.