Graphify: Kodlarınızı AI Asistanlarınızın Anlayabileceği Bir Haritaya Dönüştürüyor

Hadi açık konuşalım: Çoğumuz aylardır dokunmadığımız bir kod tabanını açıp o tanıdık dehşeti hemen hissediyoruz. Dosyaların orada olduğunu biliyorsunuz. Mimariyi kabaca hatırlıyorsunuz. Ama noktaları birbirine bağlamak? O bir arkeoloji projesi.

Graphify tam da bunu değiştirmek istiyor — özellikle AI coding assistant'lar için.

Graphify Nedir, Neden Önemli?

Graphify, tüm kod tabanınızdan sorgulanabilir bir bilgi grafiği oluşturan açık kaynaklı bir araç. Kaynak kod, dokümantasyon, araştırma makaleleri ve hatta diyagramlar — hepsi tek bir aranabilir grafikte birleştiriliyor. Bu grafik, kodunuzun ne yaptığını değil, aynı zamanda neden o şekilde tasarlandığını da açıklıyor.

Yani AI asistanınıza bir dizi dosya yığını vermek yerine, projenizin haritasını veriyorsunuz.

Araç, Safi Shamsi tarafından geliştirilmiş ve MIT lisansıyla yayınlanmış. Sağlam temeller üzerinde çalışıyor: Graf işlemleri için NetworkX ve statik kod analizi için Tree-sitter.

Çok Modlu Yaklaşımın Gücü

Graphify'ı ilginç kılan şey: Sadece kodu parse etmiyor. Farklı girdi türlerini işliyor:

• Kaynak kod (.py, .js, .go, .java ve daha fazlası) — Tree-sitter soyut sözdizimi ağaçlarını, çağrı grafiklerini ve docstring'leri çıkarıyor
• Markdown ve PDF'ler — LLM destekli çıkarım, düz yazıdan kavramları çekiyor
• Diyagramlar ve görseller — Vizyon modelleri mimari diyagramlarınızı okuyabiliyor

Bu çok modlu yaklaşım, sadece bir çağrı grafiği değil, farklı dosya türleri ve formatları arasında semantik ilişkiler elde ettiğiniz anlamına geliyor.

Dağınık Repodan Etkileşimli Grave

Pipeline basit ama güçlü:

1. Tespit et ve topla — Tüm ilgili dosyaları bul
2. Çıkar — AST'leri ve semantik düğüm/kenar çiftlerini çek
3. İnşa et — Bir NetworkX grafiği oluştur
4. Kümeleme — Topluluk tespiti için Leiden algoritmasını uygula
5. Analiz et — "Tanrı düğümleri"ni (yüksek merkezilikli dosyalar) ve beklenmedik bağlantıları belirle
6. Raporla — Okunabilir çıktı üret

Topluluk tespiti kısmı özellikle zekice. Graphify, vektör gömme (embedding) yöntemlerine güvenmek yerine — ki bu hem pahalı hem belirsiz olabilir — kodla ilgili parçaları semantik kümeler halinde gruplamak için Leiden algoritmasını kullanıyor. Gömme modeli gerekmiyor.

Tanrı Düğümleri ve "Sürprizler"

Dikkatimi çeken bir özellik: Graphify, grafikteki en yüksek bağlantıya sahip dosya veya bileşenleri "god node" (tanrı düğümü) olarak adlandırıyor. Bunlar genellikle temel sınıflarınız, ana giriş noktalarınız veya kritik paylaşılan yardımcı programlarınız oluyor.

Daha ilginç olanı, "sürpriz" olarak işaretliyor — beklenmedik çapraz dosya veya çapraz alan bağlantıları. Bunlar tasarım sorunlarına, belgelenmemiş bağımlılıklara veya araştırılması gereken alanlara işaret edebilir.

httpx kütüphanesiyle yaptıkları örneklerden birinde, Graphify DigestAuth ile Response arasında beklenmedik bir bağlantı buldu. Tek tek dosyaları okuyunca belli olmayan ama graf olarak görselleştirildiğinde kristal berraklığında ortaya çıkan bir ilişki bu.

Token Verimliliği Argumentı

Akılda tutulması gereken bir sayı: Karışık derlem kıyaslamasında (GPT framework repoları ve araştırma makaleleri), Graphify saf context injection yaklaşımlarına kıyasla token kullanımında 71.5× azalma sağladı.

Bu önemsiz değil. AI API çağrıları için token başına ödeme yapıyorsanız, sorgu maliyetlerini o kadar büyük bir marjla düşürmek fark yaratıyor. Ve mesele sadece para değil — daha küçük context pencereleri daha hızlı yanıtlar ve daha az halüsinasyon riski anlamına geliyor.

Göz Ardı Edilmeyen Güvenlik

URL'leri çeken ve kod işleyen açık kaynaklı araçların güvenliği ciddiye alması gerekiyor. Graphify bunu yapıyor:

• Sadece http/https URL'lerine izin veriyor
• İndirmelerde boyut ve zaman aşımı sınırları var
• Yol containment kontrolleri mevcut (dizin geçişi yok)
• Tüm düğüm etiketlerinde HTML escaping uygulanıyor
• Telemetri veya üçüncü taraf veri toplama yok

Kodunuz asla ortamınızdan çıkmıyor. Graphify sadece semantik açıklamaları — ham kaynak kodu değil — yapılandırılmış AI modelinize gönderiyor.

AI Asistanlarla Entegrasyon

Graphify, Claude Code, Codex ve OpenCode için basit komutlarla geliyor:

• /graphify — Yeni bir graf oluştur
• /graphify query <soru> — Kod tabanınız hakkında sorular sorun
• /graphify path <dosya> — Belirli yollara odaklanın
• /graphify explain — Graf yapısının açıklamalarını alın

Çıktılar arasında etkileşimli bir graph.html görselleştirmesi, programatik erişim için bir graph.json ve bir GRAPH_REPORT.md denetim dosyası var.

Kurulum

Denemek isterseniz:

pip install graphifyy
graphify install
graphify ./projeniz

Gereksinimler: Python 3.10+ ve tercih ettiğiniz AI modeli (Claude, OpenAI vb.) için yapılandırılmış bir API anahtarı.

Ekosistem İçindeki Yeri

Graphify, Sourcegraph'ın kurumsal kod arama özelliğini veya Neo4j'nin genel amaçlı graf veritabanını değiştirmeye çalışmıyor. Bunun yerine ilginç bir orta zemin işgal ediyor:

• Statik analiz araçlarından daha semantik
• Vektör tabanlı geri alma yöntemlerinden daha yapılandırılmış
• AI asistanı context injection için özel olarak oluşturulmuş

Karmaşık projelerde AI coding assistant'larla çalışan geliştiriciler için — özellikle dokümantasyon ve araştırma içeren karma kod tabanlarında — gerçek bir boşluğu dolduruyor.

Büyük Resim

Graphify gibi araçlar daha geniş bir trendi temsil ediyor: Sadece kod üreten değil, üzerinde çalıştıkları sistemleri gerçekten anlayan AI asistanları. Bir bilgi grafiği sadece bir görselleştirme hilesi değil — daha doğru, bağlam duyarlı öneriler sunabilecek bir muhakeme yapısı.

Graphify'ın AI kod anlama standardı olup olmayacağını zaman gösterecek. Ama çözdüğü problem gerçek. Kod tabanları karmaşık, birbirine bağlı sistemler. Belki de dosya ağacı gezginleri yerine graf tabanlı araçları hak ediyorlar.

AI asistanlarınızın projenizin mimarisini anlamasını sağlamakta zorlanıyorsanız, Graphify bir öğleden sonra denemesi yapmaya değer olabilir.