Primeiros passos

O Guida é um sistema de automação de navegador para Windows baseado em WebView2. Guida Complete é o app desktop normal. Guida Node é um executor remoto headed para automação de navegador e espaço de trabalho. Ambos podem expor Remote Ops, enquanto MCP continua sendo a superfície local de integração com agentes de IA.

A maioria dos usuários não precisa de toda a superfície do produto no primeiro dia. Escolha o caminho que corresponde ao que você quer fazer primeiro.

Escolha seu caminho

Quero automatizar tarefas do navegador manualmente

Comece aqui se você quer clicar, digitar, navegar, extrair conteúdo e executar scripts por conta própria.

1. Instale o Guida
2. Execute seu primeiro script
3. Experimente a receita para abrir uma página e inspecioná-la
4. Use Tools > Developer > Generate Scripting Support Files… para gerar completações do editor, guias de linguagem e arquivos de contexto para LLM local

Quero que um agente de IA navegue sob supervisão

Comece aqui se você quer que Claude Code, Claude Desktop ou outro cliente MCP opere o Guida com aprovações, controles de domínio e histórico de auditoria.

1. Leia Integração MCP
2. Abra um espaço de trabalho para que o agente tenha scripts e configuração locais ao projeto
3. Adicione ferramentas personalizadas quando o agente precisar de ações repetíveis específicas do espaço de trabalho
4. Revise Código aberto e código fechado para entender o que permanece local, o que é auditado e o que a camada fechada de extração cobre

Quero extrair e armazenar dados

Comece aqui se seu primeiro objetivo é extração, armazenamento local ou envio de dados extraídos para sistemas externos.

1. Execute o Início rápido para aprender o ciclo básico de script
2. Experimente a receita para extrair e armazenar dados de página
3. Leia Dados e armazenamento para g.store, g.queue, g.search, armazenamento compatível com S3, MongoDB, PostgreSQL e Elasticsearch
4. Use Integrações com bancos de dados quando precisar de bancos externos ou armazenamento de objetos

Quero processar filas e processos de trabalho

Comece aqui se você tem muitas URLs ou registros para processar em várias guias do navegador.

1. Abra um espaço de trabalho para que o Guida possa criar bancos de filas e armazenamento
2. Experimente a receita para enfileirar URLs e processá-las
3. Leia Processos de trabalho das filas para grupos declarativos e programáticos
4. Experimente a receita para executar processos de trabalho em paralelo

Quero um nó de execução remoto

Comece aqui se você quer que outra máquina execute automação de navegador headed, processos de trabalho do espaço de trabalho, filas e Remote Ops enquanto você a controla por um canal privado confiável.

1. Instale Guida Node apenas se precisar especificamente de execução remota; caso contrário instale Guida Complete
2. Leia Instalação para escolher entre Guida Complete e Guida Node
3. Leia API Remote Ops para o plano de controle JSON-RPC por canal confiável
4. Use Remote View quando um cliente precisar transmitir ou controlar uma guia de navegador ativa

Quero recursos de LLM local

Comece aqui se você quer que scripts classifiquem, resumam ou extraiam dados com um modelo local.

1. Configure LLM com Ollama ou LlamaSharp
2. Experimente a receita para perguntar ao LLM local
3. Leia IA, HTTP e ferramentas para g.llm.promptLocalLlm() e auxiliares HTTP
4. Combine chamadas LLM com processos de trabalho das filas para classificação ou extração em lote

Quero entender segurança e credenciais

Comece aqui se você está avaliando o Guida para fluxos sensíveis, credenciais de API ou navegação assistida por IA.

1. Leia Integração MCP para lista de domínios permitidos, aprovação de ferramentas e registro de auditoria
2. Leia Credenciais para credenciais criptografadas com DPAPI e restrições de origem MCP
3. Leia Código aberto e código fechado para entender o que é fechado, o que já é público e o que será aberto quando estiver extraído e estável
4. Leia Integrações com bancos de dados se scripts precisarem de credenciais de conexão para PostgreSQL, MongoDB, armazenamento compatível com S3 ou Elasticsearch

Ações iniciais comuns

Tarefa	Comece aqui
Instalar o Guida	Instalação
Escolher Complete ou Node	Instalação
Executar seu primeiro script	Início rápido
Abrir um espaço de trabalho	Espaços de trabalho
Conectar um cliente MCP	Integração MCP
Controlar um nó remoto	API Remote Ops
Usar credenciais com segurança	Credenciais
Executar processos de trabalho das filas	Processos de trabalho das filas
Armazenar ou consultar dados extraídos	Dados e armazenamento
Capturar tráfego de rede	Receita de captura de tráfego de rede

Como funciona

Scripts usam a API g.* para controlar guias do navegador, inspecionar o DOM, armazenar dados, executar filas, chamar LLMs locais e integrar serviços do espaço de trabalho. Métodos JavaScript e Janet retornam valores diretamente e lançam erro em falha. Lua usa retornos múltiplos.

await g.nav.navigateToUrl("https://example.com");
await g.dom.waitForDomStable();

const html = await g.page.getDom();
g.store.put("pages", "example", { html });

Tudo roda na sua máquina. Dados do espaço de trabalho ficam na pasta do espaço de trabalho, o estado do aplicativo fica no perfil do seu usuário Windows, e o Guida não exige contas, telemetria nem sincronização em nuvem.