📑 Guia Completo do Graphify para Google Antigravity no Windows 11

---

O Que É o Graphify — Em Uma Frase e Uma Analogia

O Graphify é uma ferramenta que transforma qualquer pasta de arquivos do seu projeto — incluindo código, documentos, imagens e vídeos — em um mapa interativo de conexões, permitindo que você faça perguntas como "como este conceito se relaciona com aquele?" e receba respostas precisas baseadas no conteúdo real do seu projeto.

Para entender o que isso significa na prática, imagine que você tem uma cozinha bagunçada onde todos os ingredientes estão espalhados sem organização. O Graphify age como um mapa mental dinâmico: ele olha para cada ingrediente (arquivo), identifica como eles se conectam (quem usa quem, quem depende de quem), e cria um diagrama onde você pode clicar em qualquer ponto e ver instantaneamente todos os caminhos que levam até ele.

O pacote de instalação no repositório público PyPI se chama "graphifyy" (com dois "y" no final — como "flying" tem dois "y"). Já o comando usado no terminal é simplesmente "graphify" (com um "y" — como "fly" tem um "y"). Existe uma diferença oficial entre o nome do pacote e o comando, e isso não é um erro. É assim que o projeto foi concebido. Alerta importante: outros pacotes disponíveis no PyPI com nomes similares (como "graphify" sozinho ou variações) não são afiliados ao projeto oficial e podem não ter as mesmas funcionalidades. Sempre use exatamente graphifyy para instalar e graphify para executar.

---

Pré-Requisitos para Funcionar no Windows 11 com Antigravity

Antes de começar a usar o Graphify, você precisa garantir que três coisas estejam instaladas no seu computador. Cada uma delas é como uma ferramenta diferente na sua caixa de ferramentas — sem elas, não é possível montar o quebra-cabeça completo.

Python 3.10 ou superior instalado no Windows 11

O Python é uma linguagem de programação — pense nele como um idioma universal que muitas ferramentas de desenvolvimento entendem. O Graphify foi escrito nesse "idioma", então você precisa tê-lo instalado para que a ferramenta funcione. O Python não é um programa como o Word ou o Excel; é mais como um motor invisível que roda por trás de outras aplicações.

Para verificar se você já tem o Python instalado no Windows 11, abra o Prompt de Comando (digite "cmd" no menu Iniciar e clique no resultado "Prompt de Comando") e digite:

python --version

Se aparecer algo como "Python 3.10.12" ou "Python 3.11.5", você já tem o Python. Se aparecer "python não é reconhecido", você precisa instalar. Acesse o site oficial python.org, clique no botão "Download Python", e execute o instalador. Durante a instalação, marque a opção "Add Python to PATH" — isso é essencial para que o Windows encontre o Python quando você digitar comandos depois.

Google Antigravity instalado como aplicativo desktop

O Google Antigravity não é um site na internet — é um programa que você instala no seu computador, como instalaria o Word, o Excel ou qualquer outro aplicativo. Ele funciona como um ambiente de desenvolvimento inteligente onde você pode conversar com agentes de inteligência artificial enquanto trabalha nos seus arquivos.

Para instalar o Antigravity, acesse antigravity.google/download e baixe a versão para Windows. O instalador é um arquivo .exe que você executa como qualquer outro programa. Após a instalação, você encontrará o ícone do Antigravity no Menu Iniciar do Windows.

Acesso ao terminal do Windows (PowerShell ou Prompt de Comando)

O terminal é uma janela especial do Windows onde você pode digitar comandos de texto para controlar o computador — é como uma caixa de diálogo com o computador, onde em vez de clicar em botões, você escreve instruções. Pense nele como o painel de controle de uma máquina complexa: em vez de aperitivos botões com ícones amigáveis, você usa comandos escritos.

No Windows 11, você pode abrir o Prompt de Comando digitando "cmd" no menu Iniciar, ou o PowerShell digitando "powershell" no menu Iniciar. Ambos funcionam para os comandos do Graphify. O Prompt de Comando é mais simples; o PowerShell é mais poderoso e moderno. Para começar, você pode usar qualquer um dos dois — Recomendamos o Prompt de Comando para simplicidade.

---

Instalação Passo a Passo

Agora que você tem os três pré-requisitos, vamos instalar o Graphify. Siga cada etapa na ordem, sem pular nenhuma. Cada comando faz uma coisa específica, como etapas de uma receita de bolo: você precisa seguir a ordem para que o resultado funcione.

Passo 1 — Instalar o Graphify via pip

O "pip" é o gerenciador de pacotes do Python — pense nele como uma loja de ferramentas automática. Quando você quer uma ferramenta nova, o pip vai até a loja (chamada PyPI), baixa a ferramenta e instala no seu computador automaticamente. O comando para instalar é:

pip install graphifyy

Lembre-se: o nome do pacote na loja é "graphifyy" com dois "y", mesmo que o comando final seja apenas "graphify" com um "y". Isso é como comprar um produto pelo nome comercial "Graphifyy" mas usar o atalho "Graphify" depois.

Quando você executar este comando, o terminal vai mostrar texto passando na tela enquanto o pip baixa e instala o Graphify. Pode levar de segundos a poucos minutos, dependendo da velocidade da sua internet. Se aparecer uma mensagem de erro no final, anote o que diz — geralmente é algo como "Python não encontrado" (o que significa que você precisa adicionar o Python ao PATH) ou "Permissão negada" (nesse caso, tente executar o Prompt de Comando como Administrador: clique com o botão direito no ícone do Prompt de Comando e escolha "Executar como administrador").

Passo 2 — Instalar o Graphify como habilidade geral do sistema

Este comando registra o Graphify no seu computador de forma que ele fique disponível globalmente, como instalar um programa que funciona em qualquer pasta:

graphify install

Após este comando, o Graphify está disponível para ser usado com qualquer ferramenta de desenvolvimento que você tiver. Mas ainda não está conectado ao Google Antigravity — isso vem no próximo passo.

Passo 3 — Instalar o Graphify especificamente para o Google Antigravity

Este comando cria arquivos especiais dentro de uma pasta oculta chamada ".agent" na sua pasta de usuário do Windows, dizendo ao Antigravity como reconhecer e usar o Graphify:

graphify antigravity install

Este comando cria dois arquivos fundamentais na pasta do seu usuário (geralmente em C:\Users\SeuNome):

• .agent\rules\graphify.md — que contém regras sempre ativas para o Antigravity
• .agent\workflows\graphify.md — que registra o comando /graphify para que o Antigravity o reconheça

Esses arquivos são como instruções de uso que você deixa para um assistente: eles explicam ao Antigravity que existe um comando chamado "/graphify" e o que ele deve fazer quando você digitar isso.

Passo 4 — Configurar o Graphify para reconhecer o projeto local da usuária

Este passo é diferente dos anteriores porque deve ser executado dentro da pasta do seu projeto específico. Abra o Prompt de Comando, navegue até a pasta do seu projeto usando o comando cd (change directory — mudar diretório), e execute:

cd C:\caminho\para\seu\projeto
graphify antigravity install

A diferença entre este passo e o anterior é importante: o Passo 3 configura o Graphify globalmente para todos os projetos, enquanto o Passo 4 configura o Graphify especificamente para este projeto. Se você trabalha em vários projetos diferentes, pode querer que cada um tenha suas próprias configurações de grafo de conhecimento. O comando de instalação dentro da pasta do projeto cria uma configuração separada para aquele projeto específico.

---

Mapa Completo de Arquivos — Onde Cada Arquivo Fica e Por Quê

O Graphify cria e gerencia vários arquivos no seu computador. Alguns ficam "fora" do seu projeto (no diretório do seu usuário), afetando todas as sessões; outros ficam "dentro" do seu projeto, específicos para aquele trabalho. Entender onde cada arquivo fica ajuda a não excluir algo importante por engano.

GRUPO A — Arquivos globais (no diretório do seu usuário do Windows)

Estes arquivos ficam na sua pasta de usuário (geralmente C:\Users\SeuNomeDeUsuario\) e afetam o comportamento do Graphify em todas as sessões, independentemente de qual projeto você está trabalhando. Não exclua estes arquivos.

GRUPO B — Arquivos do projeto (dentro da pasta do seu projeto local)

Estes arquivos ficam dentro da pasta do seu projeto específico. Eles são criados quando você executa o comando /graphify pela primeira vez. Todos ficam dentro de uma pasta chamada graphify-out\ (graphify output — saída do graphify).

---

Como Funciona na Prática — O Que o Graphify Faz ao Ser Ativado

Quando você digita /graphify no Antigravity, a ferramenta executa um processo em três fases sequenciais, como um leitor estudioso que primeiro olha a estrutura do livro, depois transcreve áudios, e finalmente extrai o significado profundo.

Fase 1 — Leitura estruturada dos arquivos de código (sem usar inteligência artificial)

Na primeira fase, o Graphify usa uma técnica chamada AST (Abstract Syntax Tree — Árvore de Sintaxe Abstrata) para analisar seus arquivos de código. Isso é como um tradutor que consegue entender a gramática de 25 linguagens de programação diferentes e extrair informações estruturadas: onde estão definidas as funções, quais funções chamam quais outras, quais arquivos dependem de quais bibliotecas, e quais comentários explicam o "porquê" do código.

O importante aqui é que esta fase não usa inteligência artificial — é uma análise determinística, como contar palavras em um texto. Isso significa que: (a) é extremamente rápida, (b) não envia seu código para lugar nenhum na internet, e (c) os resultados são sempre os mesmos para os mesmos arquivos.

Fase 2 — Transcrição de arquivos de vídeo e áudio localmente

Se o seu projeto contém arquivos de vídeo (como .mp4, .mov, .mkv) ou áudio (como .mp3, .wav, .m4a), o Graphify transcreve o conteúdo usando uma tecnologia chamada Whisper (que funciona offline, no seu próprio computador — pense nele como um tradutor que conhece jargões técnicos e consegue transcrever com precisão). Os áudios e vídeos nunca saem do seu computador nesta fase — tudo é processado localmente.

Esta fase só acontece se você tiver instalado a extensão de vídeo com o comando: pip install "graphifyy[video]". Sem essa extensão, vídeos e áudios são ignorados.

Fase 3 — Extração semântica de documentos, PDFs e imagens (usando inteligência artificial)

Para arquivos como documentos .md (Markdown), PDFs, e imagens, o Graphify envia o conteúdo para o modelo de inteligência artificial configurado no Antigravity (geralmente o Gemini 3.1 Pro, que é o modelo padrão do Antigravity). A IA analisa o conteúdo e extrai conceitos, relações e o "raciocínio por trás" das decisões.

Nota importante sobre privacidade: nesta fase, o conteúdo dos seus documentos, PDFs e imagens é enviado para a API do modelo de IA configurado no Antigravity. Se você usa o modelo Gemini padrão do Antigravity, os dados são processados pelos servidores do Google. Sempre verifique as políticas de privacidade do modelo que está utilizando antes de processar informações sensíveis.

O conceito de "grafo de conhecimento" explicado com analogia

Imagine um mapa de conexões de的城市 (como um mapa de metrô, mas para ideias em vez de estações). Cada ponto no mapa é um conceito do seu projeto. Quando dois conceitos estão relacionados, há uma linha conectando eles. Alguns pontos têm muitas linhas (são conceitos centrais que aparecem em muitos lugares); outros têm poucas linhas (são conceitos específicos que aparecem em poucos lugares).

O Graphify classifica cada conexão em três categorias:

• EXTRACTED (Extraído diretamente): Significa que a relação foi encontrada explicitamente no código. Por exemplo, se você tem import numpy as np no início de um arquivo Python, o Graphify detecta que o arquivo "extrai" (usa) o numpy. Confiança: 100%.

• INFERRED (Inferido com confiança): Significa que o Graphify fez uma dedução razoável baseada no contexto. Por exemplo, se uma função chama outra função relacionada logisticamente, mas não há uma chamada direta no código, o Graphify pode inferir que elas estão conectadas. Cada conexão inferida tem uma pontuação de confiança entre 0.0 e 1.0 — quanto mais perto de 1.0, mais seguro é que a conexão seja real.

• AMBIGUOUS (Ambíguo — marcado para revisão humana): Significa que o Graphify encontrou algo que parece uma conexão, mas não tem certeza suficiente para classificar como Extraído ou Inferido. Ele marca isso para você decidir se a conexão faz sentido.

"God nodes" (nós divinos) explicados

Os god nodes são os conceitos mais conectados do seu projeto — pense neles como os hubs de uma rede de aeroportos (como o aeroporto de Heathrow em Londres, que conecta dezenas de destinos). No contexto do seu projeto, um "god node" seria algo que aparece em muitos lugares diferentes e conecta muitas partes do código entre si.

Na prática, identificar god nodes é útil porque: (a) se você precisa entender uma nova parte do projeto, começar por um god node ajuda a ver como ele se conecta ao resto; (b) god nodes geralmente representam conceitos fundamentais cuja mudança afetaria muitas partes do sistema.

"Surprising connections" (conexões inesperadas) explicadas

As conexões inesperadas são relações entre conceitos que não são óbvias à primeira vista. Pense nisso como descobrir que dois colega de trabalho que pareciam não se conhecer na verdade moram no mesmo bairro e vão ao mesmo academia. No contexto do seu projeto, o Graphify pode descobrir que uma função de autenticação tem uma conexão não óbvia com o módulo de relatórios — talvez porque ambos lidam com formatos de data, ou porque compartilham uma dependência comum.

O Graphify classifica essas conexões inesperadas e explica em linguagem simples por que a conexão existe, para que você possa decidir se é relevante ou não.

---

Como Usar o Graphify no Antigravity — Comandos e Modos

Agora que você entende como o Graphify funciona, vamos ver como ativá-lo dentro do Google Antigravity. O Graphify é ativado como um slash command (comando de barra): quando você digita /graphify no chat do agente, o Antigravity reconhece isso como uma instrução especial e executa o Graphify.

Comandos básicos (sempre use /graphify antes do comando no Antigravity):

/graphify . — Mapeia a pasta do projeto inteiro. Use este comando quando quiser ter uma visão geral de todo o seu projeto. É equivalente a dizer: "analise tudo que está aqui e me faça um mapa".

/graphify ./nomeDePasta — Mapeia apenas uma subpasta específica. Use quando você só quer entender uma parte do projeto, não o todo. É como pedir um mapa de um bairro específico em vez da cidade inteira.

/graphify query "minha pergunta" — Faz uma pergunta ao grafo que já foi construído. A pergunta é respondida com base nas conexões que o Graphify encontrou. Por exemplo: /graphify query "como a autenticação se conecta aos relatórios?" retornaria as conexões entre esses dois conceitos.

/graphify path "Conceito A" "Conceito B" — Encontra o caminho mais curto entre dois conceitos — como encontrar a rota mais direta entre duas estações de metrô. Se você quiser saber como ConceptA leva até ConceptB através de conceitos intermediários, use este comando.

/graphify explain "NomeDeUmConceito" — Pede uma explicação de um conceito específico do grafo em linguagem simples. O Graphify vai procurar todas as conexões desse conceito e explicar em português o que ele faz e como se relaciona com outras partes do projeto.

Modos de operação:

/graphify ./raw --mode deep — Extração mais agressiva de conexões implícitas. O modo "deep" (profundo) faz a IA trabalhar mais para encontrar conexões que não são óbvias. Use quando: o modo normal parece ter perdido conexões importantes, ou quando você está em fase de análise profunda e quer um mapa o mais completo possível. Custo: mais tempo de processamento e mais uso da API de IA.

/graphify ./raw --update — Atualiza apenas arquivos que mudaram desde a última execução. O Graphify mantém um registro de quais arquivos já foram processados (no cache). Este comando ignora arquivos inalterados e só processa os novos ou modificados. Use sempre que puder — é muito mais rápido que uma execução completa.

/graphify ./raw --watch — Monitora automaticamente mudanças em tempo real. Depois de ativar este modo, sempre que você salvar um arquivo no seu projeto, o Graphify automaticamente processará apenas aquele arquivo e atualizará o grafo. Use quando: você está em desenvolvimento ativo e quer que o mapa sempre reflita o estado atual do código. É como ter um assistente que atualiza seu mapa mental cada vez que você faz uma anotação nova.

/graphify ./raw --no-viz — Gera apenas o relatório e o arquivo JSON, sem o mapa visual HTML. Use quando: você quer velocidade máxima e não precisa do mapa interativo visual (por exemplo, em scripts automatizados).

/graphify ./raw --wiki — Gera um wiki navegável por artigos. Em vez de um mapa visual, o Graphify cria artigos em Markdown organizados por comunidades de conhecimento — como uma pequena Wikipedia do seu projeto. Use quando: você prefere ler explanations em formato de documento em vez de navegar por um mapa visual.

---

Limitações Específicas no Google Antigravity e Pontos de Atenção

Existem algumas limitações importantes que você deve conhecer ao usar o Graphify com o Google Antigravity no Windows 11.

O Antigravity não suporta hooks PreToolUse (gatilhos automáticos antes de buscas)

Diferentemente de outras plataformas de codificação assistida por IA (como Claude Code, por exemplo), o Antigravity não possui um mecanismo de "gatilho automático" que ativa o Graphify antes de cada operação de busca de arquivo. Isso significa que no Antigravity, o Graphify funciona de forma diferente: em vez de ativar automaticamente quando você faz uma busca, ele precisa ser explicitamente invocado através do comando /graphify ou através das regras sempre presentes nos arquivos .agent\rules\graphify.md.

Na prática: quando você instala o Graphify para Antigravity (graphify antigravity install), o instalador cria regras nos arquivos .agent\rules\graphify.md e .agent\workflows\graphify.md. Essas regras fazem com que o Antigravity "lembre" do Graphify e inclua contexto do grafo quando relevante, mas não disparam automaticamente antes de cada operação. Você ainda precisa usar /graphify query para fazer perguntas ao grafo.

Privacidade dos seus arquivos

Conforme explicado na seção de funcionamento, a privacidade dos seus dados depende do tipo de arquivo:

• Arquivos de código (.py, .js, .ts, etc.): processados localmente via análise AST — nada é enviado à internet.
• Vídeos e áudios: transcritos localmente via Whisper — nunca saem do seu computador.
• Documentos, PDFs e imagens: enviados ao modelo de IA configurado no Antigravity (geralmente Gemini 3.1 Pro via API do Google). O conteúdo é processado nos servidores do Google conforme suas políticas de privacidade.

Você é responsável por verificar as políticas de privacidade do modelo de IA que está usando no Antigravity. Se você configurou um modelo diferente (como Claude Sonnet 4.5 ou GPT-OSS, que são suportados pelo Antigravity), verifique a política de privacidade daquele provedor específico.

O Graphify não possui servidor próprio nem banco de dados na nuvem

Tudo roda localmente no seu computador. Não há uma conta Graphify, não há dados guardados em servidores externos, não há necessidade de login ou autenticação. Você pode usar o Graphify offline depois de instalado.

Funcionalidades de vídeo e áudio requerem pacote adicional

Se o seu projeto contém arquivos de vídeo ou áudio e você quer que o Graphify os processe, é necessário instalar uma extensão adicional:

pip install "graphifyy[video]"

Sem esta extensão, vídeos e áudios são simplesmente ignorados durante a construção do grafo.

[INSERIR DADO — Limitações específicas do Antigravity que não puderam ser confirmadas nas fontes verificadas até 15/04/2026]: Os detalhes específicos sobre como o Antigravity processa tokens, limites de contexto, ou configurações específicas do modelo para integração com ferramentas externas não puderam ser verificados com precisão na documentação disponível. Recomenda-se consultar a documentação oficial do Antigravity em antigravity.google/docs para informações sobre configurações avançadas do modelo.

---

Perguntas Frequentes de Quem Nunca Programou (FAQ)

O que é esse "terminal" que preciso abrir?

O terminal (também chamado de Prompt de Comando ou PowerShell no Windows) é uma janela onde você digita comandos de texto para dar instruções ao computador. Pense nele como uma caixa de diálogo onde você escreve o que quer que o computador faça, em vez de clicar em botões. Para abrir no Windows 11: clique no botão Iniciar, digite "cmd" ou "prompt de comando", e clique no resultado. É seguro — você não vai quebrar nada digitando os comandos deste guia.

Vou precisar saber programar para usar isso?

Não. O Graphify foi projetado para funcionar mesmo que você nunca tenha escrito uma linha de código. Você precisa saber apenas três coisas básicas: (1) como abrir o terminal, (2) como navegar até uma pasta usando o comando cd (o nome vem de "change directory" — mudar de diretório), e (3) como copiar e colar comandos. Se você consegue usar o Windows, consegue usar o Graphify.

Meus arquivos vão para a internet?

Depende do tipo de arquivo. Seus arquivos de código (.py, .js, etc.) nunca saem do seu computador — são processados localmente. Seus vídeos e áudios também são transcritos localmente e nunca saem da sua máquina. Apenas documentos, PDFs e imagens são enviados ao modelo de IA configurado no Antigravity. Se isso é uma preocupação, você pode usar o Graphify para analisar apenas código (ignorar documentos) criando um arquivo .graphifyignore que exclua suas pastas de documentos.

Preciso rodar o /graphify toda vez que abro o projeto?

Não. Você pode construir o grafo uma vez com /graphify . e depois fazer consultas quantas vezes quiser com /graphify query. O grafo fica salvo no arquivo graphify-out\graph.json e você pode consultá-lo por semanas depois sem precisar reconstruí-lo. Se você usar --watch, o grafo será atualizado automaticamente cada vez que você salvar um arquivo — aí sim você nunca precisa rodar manualmente.

O que acontece se eu excluir a pasta graphify-out?

Nada de ruim acontece. A pasta graphify-out\ contém apenas os resultados da análise — o mapa, o relatório, e o banco de dados do grafo. Se você excluí-la, você perde o grafo que foi construído, mas seus arquivos originais permanecem intactos. Você pode reconstruir o grafo a qualquer momento rodando /graphify . novamente. É como apagar um mapa impresso — você pode fazer um novo.

Posso usar o Graphify em português?

Os comandos e a interface do Graphify são todos em inglês, mas os conceitos que você pode perguntar podem ser em qualquer idioma — o Graphify vai procurar no seu projeto e responder no idioma da sua pergunta. Se você perguntar "como a autenticação funciona?" em português, vai receber a resposta em português.

O que significa o erro "python não é reconhecido"?

Significa que o Windows não encontrou o Python instalado. Isso acontece quando o Python não foi adicionado ao PATH do sistema durante a instalação. Para resolver: (1) vá ao Painel de Controle → Sistema → Configurações avançadas do sistema; (2) clique em "Variáveis de Ambiente"; (3) na seção "Variáveis do Sistema", encontre a variável "Path" e clique em "Editar"; (4) clique em "Novo" e adicione o caminho C:\Users\SeuNome\AppData\Local\Programs\Python\PythonXXX\ (substitua XXX pela versão) e também C:\Users\SeuNome\AppData\Local\Programs\Python\PythonXXX\Scripts\; (5) feche e reabra o terminal. Alternativamente, desinstale e reinstale o Python marcando a opção "Add Python to PATH".

Posso ter vários grafos para projetos diferentes?

Sim. Cada projeto pode ter seu próprio grafo independente. Se você executar /graphify . dentro da pasta do Projeto A, o grafo será salvo em ProjetoA\graphify-out\. Se depois você executar /graphify . dentro da pasta do Projeto B, o grafo será salvo em ProjetoB\graphify-out\. Eles são completamente independentes. Você também pode configurar o Graphify para ser sempre ativo em cada projeto executando graphify antigravity install dentro de cada pasta de projeto.

O que é o arquivo .graphifyignore e como eu crio?

O arquivo .graphifyignore é uma lista de pastas e arquivos que o Graphify deve ignorar durante a análise. Pense nele como uma placa de "não perturbe" em uma porta de hotel. Para criar: abra o Bloco de Notas (ou qualquer editor de texto), adicione uma linha para cada pasta ou arquivo que quer ignorar (por exemplo, node_modules/ ou dist/ ou *.log), salve o arquivo com o nome exatamente .graphifyignore (incluindo o ponto no início, sem extensão) na raiz do seu projeto. Não use espaços no nome do arquivo.

---

Síntese Final

O Graphify é uma ferramenta poderosa que transforma a bagunça de arquivos de um projeto em um mapa claro de conexões — permitindo que você entenda não apenas o que existe no seu projeto, mas como cada parte se relaciona com as outras.安装 é simples em quatro passos, e o uso se resume a digitar comandos simples como /graphify . para analisar ou /graphify query "sua pergunta" para consultar. No Google Antigravity no Windows 11, o Graphify funciona através de regras sempre ativas e do comando de barra /graphify, com todos os arquivos de saída guardados na pasta graphify-out\ do seu projeto. O processamento de código é 100% local (privado), enquanto documentos e imagens são enviados ao modelo de IA que você configurou no Antigravity.