Installation

Guida runs on Windows 10/11 (x64). It requires two runtime dependencies.

Prerequisites

.NET 9 Runtime

Guida is built on .NET 9. You need both:

1. .NET Desktop Runtime 9.0 — for the WPF UI
2. ASP.NET Core Runtime 9.0 — for the built-in Hosted API, MCP, dashboard, and Remote Ops surfaces

Download both from dotnet.microsoft.com/download/dotnet/9.0. Look for the “Runtime” section.

If you’re missing either runtime, Windows will prompt you to download it on first launch.

WebView2 Runtime

Guida uses Microsoft Edge WebView2 for the browser engine. It’s pre-installed on Windows 10 (April 2018+) and Windows 11. If you don’t have it:

Download from developer.microsoft.com/microsoft-edge/webview2.

Download

Guida now ships two Windows downloads:

• Download Guida Complete — recommended for most users. This is the full desktop app with browser automation, MCP, scripting, queues, workflow tools, and operator UI.
• Download Guida Node — for advanced remote execution. It runs headed browser automation and workspace workers through the Remote Ops API.

Most users should install Guida Complete first. Use Guida Node when you specifically want a remote/headed executor on another machine, laptop, VPS-connected private network, or automation node.

The Guida Node zip package is also available for manual extraction and NetBird/private-network testing.

A Software Bill of Materials (SBOM) is available in CycloneDX format.

For what is closed, what is already public, and what will be opened once extracted and stable, see Source Boundaries.

Windows SmartScreen warning

Because Guida is not yet code-signed, Windows SmartScreen may show a warning the first time you run it:

1. Click “More info”
2. Click “Run anyway”

This only happens once. To remove the warning permanently, right-click the downloaded Guida Complete installer, open Properties, and check “Unblock” at the bottom of the General tab, then click OK.

First launch

1. Double-click the Guida Complete installer
2. Complete the installer prompts
3. Launch Guida
4. The browser window opens with a blank tab
5. Navigate to any URL using the address bar

That’s it. You’re ready to start scripting.

Optional: Guida Node

Guida Node is not the normal desktop starting point. It is a headed WebView2 executor for remote automation scenarios:

• run workspace workers and queues on a remote machine;
• expose Remote Ops for trusted-channel browser control, telemetry, audit, workspace files, captured results, and workflow recovery;
• keep a local headed browser surface so automation behaves like real WebView2 browser execution.

Guida Node intentionally does not include the full Complete desktop operator UI, raw MCP by default, or Complete-only local features such as rich pane layouts, local speech, OCR recognition, and interactive secret dialogs. Use Guida Complete when you want the full app experience; use Node when you already know you need remote execution.

Optional: AI setup

To use Guida’s AI features, you need a local LLM backend:

• Ollama (recommended) — Install from ollama.com, then pull a model: ollama pull llama3.2

Configure the AI backend in Settings > AI Assistant.