Instalação

O Guida roda no Windows 10/11 (x64). Ele exige duas dependências de runtime.

Pré-requisitos

.NET 9 Runtime

O Guida é construído sobre .NET 9. Você precisa de ambos:

1. .NET Desktop Runtime 9.0 — para a interface WPF
2. ASP.NET Core Runtime 9.0 — para Hosted API, MCP, painel e superfícies Remote Ops integrados

Baixe ambos em dotnet.microsoft.com/download/dotnet/9.0. Procure a seção “Runtime”.

Se algum runtime estiver ausente, o Windows solicitará o download na primeira execução.

WebView2 Runtime

O Guida usa Microsoft Edge WebView2 como mecanismo de navegador. Ele vem pré-instalado no Windows 10 (abril de 2018+) e no Windows 11. Se você não o tiver:

Baixe em developer.microsoft.com/microsoft-edge/webview2.

Download

O Guida agora oferece dois downloads para Windows:

• Baixar Guida Complete — recomendado para a maioria dos usuários. É o app desktop completo com automação do navegador, MCP, scripting, filas, ferramentas de fluxo de trabalho e interface de operador.
• Baixar Guida Node — para execução remota avançada. Executa automação de navegador headed e processos de trabalho do espaço de trabalho pela API Remote Ops.

A maioria dos usuários deve instalar Guida Complete primeiro. Use Guida Node quando quiser especificamente um executor remoto/headed em outra máquina, notebook, rede privada conectada por VPS ou nó de automação.

O pacote zip do Guida Node também está disponível para extração manual e testes com NetBird/rede privada.

Uma Software Bill of Materials (SBOM) está disponível no formato CycloneDX.

Para entender o que é fechado, o que já é público e o que será aberto quando estiver extraído e estável, consulte Código aberto e código fechado.

Aviso do Windows SmartScreen

Como o Guida ainda não tem assinatura de código, o Windows SmartScreen pode mostrar um aviso na primeira execução:

1. Clique em “More info”
2. Clique em “Run anyway”

Isso acontece apenas uma vez. Para remover o aviso permanentemente, clique com o botão direito no instalador Guida Complete baixado, abra Properties, marque “Unblock” na parte inferior da guia General e clique em OK.

Primeira execução

1. Clique duas vezes no instalador Guida Complete
2. Conclua as etapas do instalador
3. Abra o Guida
4. A janela do navegador abre com uma guia em branco
5. Navegue para qualquer URL usando a barra de endereços

Pronto. Você já pode começar a criar scripts.

Opcional: Guida Node

Guida Node não é o ponto de partida normal para uso desktop. É um executor WebView2 headed para cenários de automação remota:

• executar processos de trabalho do espaço de trabalho e filas em uma máquina remota;
• expor Remote Ops para controle do navegador por canal confiável, telemetria, registro de auditoria, arquivos do espaço de trabalho, resultados capturados e recuperação de fluxos de trabalho;
• manter uma superfície de navegador headed local para que a automação se comporte como execução real de navegador WebView2.

Guida Node não inclui intencionalmente a interface completa de operador desktop do Complete, MCP bruto por padrão nem recursos locais exclusivos do Complete, como layouts avançados de painéis, voz local, reconhecimento OCR e diálogos interativos de credenciais. Use Guida Complete quando quiser a experiência completa do app; use Node quando já souber que precisa de execução remota.

Opcional: configuração de IA

Para usar os recursos de IA do Guida, você precisa de um backend LLM local:

• Ollama (recomendado) — instale em ollama.com e depois baixe um modelo: ollama pull llama3.2

Configure o backend de IA em Settings > AI Assistant.