설치

Guida는 Windows 10/11(x64)에서 실행됩니다. 두 가지 런타임 의존성이 필요합니다.

전제 조건

.NET 9 Runtime

Guida는 .NET 9 기반입니다. 다음 두 항목이 모두 필요합니다.

.NET Desktop Runtime 9.0 - WPF UI용
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용 다운로드를 두 가지 제공합니다.

Guida Complete 다운로드 - 대부분의 사용자에게 권장됩니다. 브라우저 자동화, MCP, 스크립팅, 큐, 워크플로 도구, 운영자 UI가 포함된 전체 데스크톱 앱입니다.
Guida Node 다운로드 - 고급 원격 실행용입니다. Remote Ops API를 통해 headed 브라우저 자동화와 워크스페이스 워커를 실행합니다.

대부분의 사용자는 Guida Complete를 먼저 설치해야 합니다. 다른 컴퓨터, 노트북, VPS로 연결된 사설 네트워크 또는 자동화 노드에서 remote/headed executor가 필요할 때만 Guida Node를 사용하세요.

Guida Node zip 패키지도 수동 압축 해제와 NetBird/사설 네트워크 테스트용으로 제공됩니다.

CycloneDX 형식의 Software Bill of Materials(SBOM)도 공개되어 있습니다.

무엇이 비공개 소스이고, 무엇이 이미 공개되어 있으며, 어떤 부분을 추출과 안정화 이후 공개할 계획인지는 오픈 소스와 비공개 소스를 참조하세요.

Windows SmartScreen 경고

Guida는 아직 코드 서명되어 있지 않기 때문에 첫 실행 시 Windows SmartScreen 경고가 표시될 수 있습니다.

“More info” 클릭
“Run anyway” 클릭

보통 한 번만 발생합니다. 경고를 영구적으로 없애려면 다운로드한 Guida Complete 설치 프로그램을 마우스 오른쪽 버튼으로 클릭해 Properties를 열고, General 탭 아래쪽의 “Unblock” 을 체크한 뒤 OK를 누릅니다.

첫 실행

Guida Complete 설치 프로그램 더블 클릭
설치 프로그램 안내 완료
Guida 실행
빈 탭이 있는 브라우저 창이 열림
주소 표시줄에서 원하는 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 에서 설정합니다.