インストール

Guida は Windows 10/11（x64）で動作します。2 つのランタイム依存関係が必要です。

前提条件

.NET 9 Runtime

Guida は .NET 9 を基盤にしています。次の両方が必要です。

1. .NET Desktop Runtime 9.0 - WPF UI 用
2. ASP.NET Core Runtime 9.0 - 内蔵 Hosted API、MCP、ダッシュボード、Remote Ops サーフェス用

どちらも dotnet.microsoft.com/download/dotnet/9.0 からダウンロードできます。“Runtime” セクションを探してください。

どちらかのランタイムがない場合、初回起動時に Windows がダウンロードを促します。

WebView2 Runtime

Guida はブラウザーエンジンとして Microsoft Edge WebView2 を使います。Windows 10（2018 年 4 月以降）と Windows 11 には通常プリインストールされています。入っていない場合は次から入手できます。

developer.microsoft.com/microsoft-edge/webview2

ダウンロード

Guida には Windows 向けに 2 つのダウンロードがあります。

• Guida Complete をダウンロード - ほとんどのユーザーに推奨されます。ブラウザー自動化、MCP、スクリプティング、キュー、ワークフロー用ツール、オペレーター UI を含む完全なデスクトップアプリです。
• Guida Node をダウンロード - 高度なリモート実行向けです。Remote Ops API 経由で headed ブラウザー自動化とワークスペースワーカーを実行します。

ほとんどのユーザーはまず Guida Complete をインストールしてください。別のマシン、ノート PC、VPS 接続のプライベートネットワーク、または自動化ノードで remote/headed executor が必要な場合だけ Guida Node を使います。

Guida Node zip パッケージも、手動展開と NetBird/プライベートネットワークでのテスト用に利用できます。

CycloneDX 形式の Software Bill of Materials (SBOM) も公開されています。

何がクローズドソースで、何がすでに公開されており、どの部分を抽出と安定化の後に公開する予定かは、オープンソースとクローズドソースを参照してください。

Windows SmartScreen の警告

Guida はまだコード署名されていないため、初回実行時に Windows SmartScreen が警告を表示することがあります。

1. “More info” をクリック
2. “Run anyway” をクリック

これは通常 1 回だけ発生します。警告を恒久的に消したい場合は、ダウンロードした Guida Complete インストーラーを右クリックして Properties を開き、General タブ下部の “Unblock” をチェックして OK を押します。

初回起動

1. Guida Complete インストーラーをダブルクリック
2. インストーラーの案内を完了
3. Guida を起動
4. 空のタブを持つブラウザーウィンドウが開く
5. アドレスバーから任意の URL へ移動

これでスクリプティングを始められます。

任意: Guida Node

Guida Node は通常のデスクトップ利用の出発点ではありません。リモート自動化シナリオ向けの headed WebView2 executor です。

• リモートマシンでワークスペースワーカーとキューを実行する。
• 信頼済みチャネルでのブラウザー制御、テレメトリ、監査履歴、ワークスペースファイル、取得済み結果、ワークフロー復旧のために Remote Ops を公開する。
• 自動化が実際の WebView2 ブラウザー実行として動くように、ローカルの headed ブラウザーサーフェスを維持する。

Guida Node には、Complete の完全なデスクトップオペレーター UI、既定の raw MCP、豊富なペインレイアウト、ローカル音声、OCR 認識、認証情報の対話ダイアログなど Complete 専用のローカル機能は意図的に含まれません。完全なアプリ体験が必要な場合は Guida Complete を使い、リモート実行が必要だと分かっている場合に Node を使います。

任意: AI 設定

Guida の AI 機能を使うには、ローカル LLM バックエンドが必要です。

• Ollama（推奨） - ollama.com からインストールし、モデルを取得します: ollama pull llama3.2

AI バックエンドは Settings > AI Assistant で設定します。