Installation

Guida läuft unter Windows 10/11 (x64) und benötigt zwei Runtime-Abhängigkeiten.

Voraussetzungen

.NET 9 Runtime

Guida basiert auf .NET 9. Installieren Sie beide Runtimes:

1. .NET Desktop Runtime 9.0 - für die WPF-Oberfläche
2. ASP.NET Core Runtime 9.0 - für Hosted API, MCP, Dashboard und Remote-Ops-Oberflächen

Beide Downloads finden Sie unter dotnet.microsoft.com/download/dotnet/9.0, im Bereich “Runtime”.

Wenn eine Runtime fehlt, fordert Windows Sie beim ersten Start zum Download auf.

WebView2 Runtime

Guida nutzt Microsoft Edge WebView2 als Browser-Engine. Unter Windows 10 (April 2018 oder neuer) und Windows 11 ist WebView2 normalerweise vorinstalliert. Falls nicht:

Laden Sie WebView2 von developer.microsoft.com/microsoft-edge/webview2 herunter.

Download

Guida bietet jetzt zwei Windows-Downloads:

• Guida Complete herunterladen - empfohlen für die meisten Anwender. Das ist die vollständige Desktop-App mit Browserautomatisierung, MCP, Scripting, Warteschlangen, Workflow-Werkzeugen und Bedienoberfläche.
• Guida Node herunterladen - für fortgeschrittene Remote-Ausführung. Führt headed Browserautomatisierung und Arbeitsbereichs-Worker über die Remote Ops API aus.

Die meisten Anwender sollten zuerst Guida Complete installieren. Verwenden Sie Guida Node, wenn Sie gezielt einen Remote-/headed Executor auf einer anderen Maschine, einem Laptop, einem per VPS angebundenen privaten Netzwerk oder einem Automatisierungsknoten benötigen.

Das Guida-Node-Zip-Paket ist ebenfalls für manuelles Entpacken und NetBird-/Private-Network-Tests verfügbar.

Eine Software Bill of Materials (SBOM) ist im CycloneDX-Format verfügbar.

Welche Teile geschlossen sind, was bereits öffentlich ist und was nach Extraktion und Stabilisierung geöffnet werden soll, steht unter Offener und geschlossener Quellcode.

Windows-SmartScreen-Warnung

Da Guida derzeit nicht digital signiert ist, kann Windows SmartScreen beim ersten Start eine Warnung anzeigen:

1. Klicken Sie auf More info.
2. Klicken Sie auf Run anyway.

Das passiert normalerweise nur einmal. Um die Warnung dauerhaft zu entfernen, klicken Sie mit der rechten Maustaste auf den heruntergeladenen Guida-Complete-Installer, öffnen Properties, aktivieren unten im Reiter General die Option Unblock und bestätigen mit OK.

Erster Start

1. Den Guida-Complete-Installer doppelklicken
2. Installationsschritte abschließen
3. Guida starten
4. Das Browserfenster öffnet sich mit einem leeren Tab
5. Über die Adressleiste eine beliebige URL öffnen

Danach können Sie mit dem Scripting beginnen.

Optional: Guida Node

Guida Node ist nicht der normale Desktop-Einstieg. Es ist ein headed WebView2-Executor für Remote-Automatisierungsszenarien:

• Arbeitsbereichs-Worker und Warteschlangen auf einer Remote-Maschine ausführen;
• Remote Ops für Browsersteuerung über einen vertrauenswürdigen Kanal, Telemetrie, Audit-Protokoll, Arbeitsbereichsdateien, erfasste Ergebnisse und Workflow-Wiederherstellung bereitstellen;
• eine lokale headed Browseroberfläche behalten, damit Automatisierung sich wie echte WebView2-Browserausführung verhält.

Guida Node enthält absichtlich nicht die vollständige Complete-Desktop-Bedienoberfläche, kein rohes MCP standardmäßig und keine Complete-only-Funktionen wie umfangreiche Panel-Layouts, lokale Sprache, OCR-Erkennung und interaktive Dialoge für Zugangsdaten. Verwenden Sie Guida Complete, wenn Sie die vollständige App-Erfahrung möchten; verwenden Sie Node, wenn Sie bereits wissen, dass Sie Remote-Ausführung benötigen.

Optional: KI einrichten

Für die KI-Funktionen von Guida benötigen Sie ein lokales LLM-Backend:

• Ollama (empfohlen) - von ollama.com installieren und ein Modell laden, zum Beispiel ollama pull llama3.2

Konfigurieren Sie das Backend unter Settings > AI Assistant.