GitHub depolarını etkileşimli mimari şemalara dönüştürün
Gitdiagram, GitHub depolarındaki karmaşık dosya yapılarını ve kod ilişkilerini saniyeler içinde görselleştiren açık kaynaklı bir araçtır. URL'deki tek bir harfi değiştirerek devasa kod tabanlarının sistem mimarisini interaktif diyagramlar halinde sunar.
Güncelleme
- 29 Ekim 2026: Yıldız 17.581 → 18.589.
- 30 Eylül 2026: Yıldız 16.568 → 17.581.
Ne kazandırır?
- Saniyeler İçinde Kod Haritası: Binlerce satırlık yabancı bir depoda kaybolmadan sistem mimarisini, ana modülleri ve veri akışını kuşbakışı görün.
- Tek Tıkla URL Kısayolu: Herhangi bir GitHub repo URL'sindeki
github.comkısmınıgitdiagram.comyaparak kurulumsuz anında şema üretin. - İnteraktif Düğümler: Şema üzerindeki kutulara tıklayarak doğrudan GitHub'daki ilgili kaynak kod dosyasına veya klasörüne gidin.
- Dışa Aktarma Desteği: Oluşturulan mimari şemaları dokümantasyon veya sunumlar için PNG, SVG veya metin biçiminde indirin.
Tek tıkla kullanım: URL değiştirme kısayolu
Gitdiagram'ın en pratik yanı hiçbir kurulum gerektirmeden tarayıcı üzerinden çalışmasıdır. İncelemek istediğiniz herhangi bir açık kaynaklı deponun adresindeki hub kelimesini silip yerine diagram yazmanız yeterlidir:
# Orijinal GitHub adresi:
https://github.com/facebook/react
# Gitdiagram etkileşimli şema adresi:
https://gitdiagram.com/facebook/reactBu bağlantıya girdiğiniz anda Gitdiagram arkaplanda depoyu tarar, dosya ağacını analiz eder ve interaktif şemayı tarayıcınızda açar.
Teknik mimari ve çalışma mantığı
Gitdiagram, kod tabanını salt metin olarak değil, ilişkisel bir sistem grafı olarak ele alır:
1. Ağaç Çıkarma (Tree Ingestion): GitHub REST ve GraphQL API'lerini kullanarak deponun dosya ağacını, paket yöneticisi tanımlarını (package.json, Cargo.toml, go.mod) ve dizin hiyerarşisini çeker.
2. Semantik Analiz ve İlişkilendirme: Modüller arasındaki import zincirlerini ve servis sınırlarını tespit eder. LLM entegrasyonu (OpenAI / Claude API) ile bileşenlerin rollerini (API Gateway, Controller, Database Adapter) etiketler.
3. Vektörel Çizim Motoru: Elde edilen grafı React Flow ve SVG tabanlı bir sanal tuvale dönüştürür. Düğümler arası veri akışı yönlü oklarla görselleştirilir.
Kurulum ve yerel dağıtım
Kendi API anahtarlarınızla çalıştırmak veya özel (private) depolarınızı kendi sunucunuzda görselleştirmek için Gitdiagram'ı yerel ortamınızda başlatabilirsiniz:
git clone https://github.com/ahmedkhaleel2004/gitdiagram.git
cd gitdiagram
bun install
cp .env.example .env# .env içine GITHUB_TOKEN ve OPENAI_API_KEY ekleyin
bun run devKod bilmiyorsanız: Yapay zekâ ajanı istemi
Gitdiagram mimarisini temel alarak incelediğim GitHub deposunun sistem şemasını oluştur. Depodaki ana bileşenleri, veri akış yönlerini, giriş noktalarını (entry points) ve harici bağımlılıkları tespit et. Mimariyi Mermaid.js formatında bir flowchart olarak çiz ve her bileşenin işlevini ikişer cümleyle açıkla.
Depo: https://github.com/ahmedkhaleel2004/gitdiagram. Kurulum ve çalıştırmada bu deponun README dosyasındaki resmî talimatları esas al.
Başlamadan önce hangi işletim sisteminde çalıştığımızı ve gerekli araçların (ör. Python, Node.js, Git, Docker) kurulu olup olmadığını kontrol et; eksik olanları bu sisteme göre adım adım kur.
Çalışmak için yeni ve boş bir klasör oluştur. Bu klasörün dışındaki dosyalarıma dokunma, hiçbir şeyi silme. Her komutu çalıştırmadan önce ne yapacağını bir cümleyle söyle.
Her adımın sonunda ekranda ne görmem gerektiğini söyle. Bir hata oluşursa hata mesajını sana olduğu gibi yapıştıracağım, birlikte düzeltelim.
Kritik uyarılar ve sınırlar
- Devasa Monorepolar: On binlerce dosya içeren monorepolarda GitHub API hız limitine (rate limit) takılabilir. Kişisel GitHub token kullanmak sınırları genişletir.
- Özel (Private) Depolar: Bulut sürümü yalnızca herkese açık (public) depoları destekler. Şirket içi kapalı depolar için aracı yerel sunucunuzda kendi token'ınızla çalıştırmalısınız.
- LLM Token Maliyeti: Kendi sunucunuzda çalıştırırken büyük repolarda harcanan LLM API token miktarını optimize etmek için dosya filtreleme kurallarını yapılandırmalısınız.
Sıkça sorulan sorular
Gitdiagram'ı kullanmak ücretli mi?
Hayır, Gitdiagram açık kaynaklıdır (MIT lisansı). Web sürümü herkese açık repolar için ücretsizdir, yerel sürümü de kendi donanımınızda bedelsiz çalıştırabilirsiniz.
Özel (private) GitHub depolarımda kullanabilir miyim?
Evet. Bunun için projeyi GitHub'dan klonlayıp kendi makinenizde çalıştırmalı ve özel deponuza erişim yetkisi olan bir GitHub Personal Access Token (PAT) tanımlamalısınız.
Büyük projelerde şema karmaşıklaşır mı?
Gitdiagram derinlik filtreleri sunar. Çok katmanlı projelerde ana dizin seviyesinde özet şema alabilir veya ilgilendiğiniz alt modülü seçip detayına inebilirsiniz.
Oluşturulan şemayı sunumuma ekleyebilir miyim?
Evet, arayüz üzerinden tek tıkla şemanın yüksek çözünürlüklü PNG veya SVG çıktısını alabilir, doğrudan tasarım ve dokümantasyon araçlarınıza yapıştırabilirsiniz.
Bağlantılar
TreScout bu aracı geliştirmedi · GitHub trendlerinde keşfedip Türkçe tanıttı. Tanıtım metni deponun kendi belgelerinden yapay zekâ ile hazırlandı. Bu sayfa deponun güncel teknik mimarisini ve açık kaynak topluluğundaki kullanım pratiklerini özetler. Detaylar için resmi depoya bakın.