Código Bagunçado? O Graphify Transforma Tudo num Cérebro Inteligente para IA
Graphify: O Mapa que sua IA precisava do seu código
Sê honesto: quantas vezes você abriu aquele projeto que não tocava há meses e sentiu vontade de chorar? Você sabe que os arquivos estão lá. Vagamente lembra da arquitetura. Mas conectar as peças? Isso virou uma expedição arqueológica.
O Graphify quer acabar com isso — pelo menos quando o assunto é dar contexto para assistentes de IA.
O que é o Graphify?
Basicamente, é uma skill open-source que constrói um grafo de conhecimento consultável a partir de toda a sua base de código.
Estamos falando de código fonte, documentação, papers de pesquisa e até diagramas — tudo unificado em um único grafo pesquisável. Ele não mostra só o que seu código faz, mas também o porquê de ter sido desenhado assim.
A ideia central? Em vez de jogar um monte de arquivos soltos para sua IA, você dá a ela um mapa do projeto.
O projeto foi criado por Safi Shamsi e sai sob licença MIT. Nos bastidores, usa o NetworkX para operações com grafos e Tree-sitter para análise estática de código. Pilhas tecnológicas bem estabelecidas, nada de experimentos arriscados.
Múltiplas Formas de "Ver" o Código
O que diferencia o Graphify é que ele não fica preso a uma única fonte de informação.
Código fonte (.py, .js, .go, .java e mais) — o Tree-sitter extrai árvores sintáticas abstratas, grafos de chamadas e docstrings.
Markdown e PDFs — modelos de LLM puxam conceitos de textos explicativos.
Diagramas e imagens — modelos de visão realmente leem seus diagramas de arquitetura.
Essa abordagem multimodal vai além de um simples call graph. Você captura relações semânticas entre conceitos espalhados em diferentes tipos de arquivo e formatos.
Do Caos ao Grafo Interativo
O pipeline funciona assim:
- Detectar e coletar — Localizar todos os arquivos relevantes
- Extrair — Pull de ASTs e nós/arestas semânticas
- Construir — Criar o grafo no NetworkX
- Agrupar — Aplicar o algoritmo de Leiden para detecção de comunidades
- Analisar — Identificar "god nodes" (arquivos altamente conectados) e conexões inesperadas
- Relatar — Gerar saída legível
A detecção de comunidades merece destaque. Em vez de depender de embeddings vetoriais (que custam caro e podem ser imprecisos), o Graphify usa Leiden para agrupar código relacionado em clusters semânticos. Nenhum modelo de embedding necessário.
God Nodes e as "Surpresas"
Uma funcionalidade que me chamou atenção: o Graphify identifica os chamados "god nodes" — arquivos ou componentes com maior conectividade no seu grafo. Geralmente são suas classes principais, pontos de entrada ou utilitários críticos compartilhados.
Mas o mais interessante mesmo são as "surprises" (surpresas). O sistema detecta conexões cruzadas entre arquivos ou domínios que não são óbvias à primeira vista. Podem indicar problemas de design, dependências não documentadas ou áreas que merecem investigação.
Em um dos exemplos com a biblioteca httpx, o Graphify encontrou uma conexão surpreendente entre DigestAuth e Response. Esse tipo de relação não fica evidente lendo arquivos individuais, mas fica cristalina quando visualizada como grafo.
A Economia de Tokens
Aqui vai um número que vale lembrar: nos benchmarks com corpus misto (repositórios de frameworks GPT + papers de pesquisa), o Graphify alcançou uma redução de 71,5× no uso de tokens comparado a abordagens de injeção de contexto ingênuas.
Isso não é detalhe. Quando você paga por token em chamadas de API de IA, cortar custos de query nessa magnitude importa. E não é só sobre dinheiro — janelas de contexto menores significam respostas mais rápidas e menos risco de alucinação.
Segurança Levada a Sério
Ferramentas open-source que fazem fetch de URLs e processam código precisam tratar segurança com cuidado. O Graphify parece estar fazendo a lição de casa:
- Só permite URLs http/https
- Limites de tamanho e timeout em downloads
- Verificações de contenção de path (sem directory traversal)
- Escaping de HTML em todos os labels de nós
- Sem telemetria ou coleta de dados de terceiros
Seu código nunca sai do seu ambiente. O Graphify só envia descrições semânticas (não código fonte cru) para o modelo de IA configurado.
Integração com Assistentes de IA
O Graphify vem com comandos simples para Claude Code, Codex e OpenCode:
/graphify— Construir um novo grafo/graphify query <pergunta>— Fazer perguntas sobre a base de código/graphify path <arquivo>— Focar em caminhos específicos/graphify explain— Obter explicações da estrutura do grafo
A saída inclui uma visualização interativa em graph.html, um graph.json para acesso programático e um arquivo GRAPH_REPORT.md para auditoria.
Como Instalar
Quer testar? É direto:
pip install graphifyy
graphify install
graphify ./seu-projeto
Requisitos: Python 3.10+ e uma API key configurada para seu modelo de IA preferido (Claude, OpenAI, etc.).
Onde o Graphify se Encaixa
Não está tentando substituir a busca de código enterprise do Sourcegraph ou o banco de dados de grafos geral do Neo4j. O Graphify ocupa um espaço interessante no meio:
- Mais semântico que ferramentas de análise estática
- Mais estruturado que recuperação baseada em vetores
- Construído especificamente para injeção de contexto em assistentes de IA
Para desenvolvedores que trabalham com assistentes de codificação em projetos complexos — especialmente bases de código mistas com documentação e pesquisa — isso preenche uma lacuna real.
O Contexto Maior
Ferramentas como o Graphify representam uma tendência mais ampla: assistentes de IA que não apenas geram código, mas realmente entendem os sistemas com que estão trabalhando. Um grafo de conhecimento não é só um truque de visualização — é uma estrutura de raciocínio que pode suportar sugestões mais precisas e conscientes do contexto.
Se o Graphify vai se tornar o padrão para compreensão de código por IA, isso ainda está por ver. Mas o problema que ele resolve é real. Bases de código são sistemas complexos e interconectados. Talvez mereçam ferramentas baseadas em grafos em vez de navegadores de árvores de arquivos.
Se você tem sofrido para fazer assistentes de IA entenderem a arquitetura do seu projeto, o Graphify pode valer um experimento de uma tarde.
Já usou ferramentas de grafos de conhecimento para entender código? Compartilha tua experiência nos comentários.