README.tr TR

Ajan token harcamanızı %80 azaltın. Graphify Cloud, ajanlarınızı yöneten, kod kalitesini yüksek tutan ve biçimsel doğrulama ile doğruluğu kanıtlayan daima açık bir bellektir. 14 günlük ücretsiz denemeyi başlatın →

Yapay zeka destekli kodlama asistanınıza /graphify yazın; tüm projenizi (kod, belgeler, PDF'ler, görseller, videolar) dosyalar arasında grep yapmak yerine sorgulayabileceğiniz bir bilgi grafiğine eşler.

• Kod haritaları ücretsiz ve tamamen yerel. Kod, tree-sitter AST ile ayrıştırılır: deterministik, LLM yok, hiçbir şey makinenizden çıkmaz. (Belgeler, PDF'ler, görseller ve video, anlamsal bir geçiş için asistanınızın modelini ya da yapılandırılmış bir API anahtarını kullanır.)
• Her kenar açıklanır. Her bağlantı EXTRACTED (kaynakta açıkça belirtilmiş) veya INFERRED (graphify tarafından çözümlenmiş) olarak etiketlenir; böylece doğrudan okunanı çıkarımla elde edilenden ayırt edebilirsiniz.
• Vektör dizini değildir. Gömme (embedding) yok, vektör deposu yok: gezinebileceğiniz gerçek bir grafik. Bir soru sorun, iki şey arasındaki yolu izleyin veya tek bir kavramı açıklayın.

[!NOTE] Bunun daima açık olmasını mı istiyorsunuz? Graphify Cloud, grafiği tüm SDLC'niz boyunca canlı tutar: monorepo ve repolar arası destek, biçimsel doğrulama ve SDLC'nize kuşbakışı bakışla kod incelemesi; ayrıca Sentry, Jira ve daha fazlası için konektörler sayesinde olaylar ve biletler kodunuzla aynı grafikte yer alır. app.graphify.com'da 14 günlük ücretsiz denemeyi başlatın.

graphify tarafından eşlenen FastAPI kod tabanı. Her düğüm bir kavram, renkler tespit edilen topluluklar ve bütün yapı graph.html içinde tıklanabilir.

Başlayın (30 saniye). Python 3.10+ ve uv (ya da pipx) gerektirir:

uv tool install graphifyy      # install the CLI (or: pipx install graphifyy)
graphify install               # detects your assistant and registers the skill

Ardından, yapay zeka asistanınızda:

/graphify .

Hepsi bu kadar. Üç dosya elde edersiniz:

graphify-out/
├── graph.html       open in any browser: click nodes, filter, search
├── GRAPH_REPORT.md  the highlights: key concepts, surprising connections, suggested questions
└── graph.json       the full graph: query it anytime without re-reading your files

Kalıcı grafik, entegrasyonların uyumsuz biçim değişikliklerini algılayabilmesi için graph.schema_version değerini ve ayrıca onu üreten Graphify sürümünü tanımlayan graph.graphify_version değerini içerir.

Tek kurulum, her asistan, her işletim sistemi. Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot ve 20'den fazlası; macOS, Linux ve Windows'ta: platformunuzu seçin.

İş başında görün¶

Grafik oluşturulduktan sonra, dosyaları okumak yerine onu sorgularsınız. Gerçek çıktı, yukarıda gösterilen FastAPI kod tabanında çalıştırılan graphify:

$ graphify explain "APIRouter"
Node: APIRouter
  Source:    routing.py L2210
  Community: 2
  Degree:    47

Connections (47):
  --> RequestValidationError [uses] [INFERRED]
  --> Dependant [uses] [INFERRED]
  --> .get() [method] [EXTRACTED]
  <-- __init__.py [imports] [EXTRACTED]
  ...

$ graphify path "FastAPI" "ModelField"
Shortest path (3 hops):
  FastAPI --uses--> DefaultPlaceholder <--references-- get_request_handler() --references--> ModelField

Her kenar bir güven etiketi taşır (EXTRACTED = kaynakta açıkça belirtilmiş, INFERRED = çözümleme ile türetilmiş); böylece doğrudan okunanı çıkarımla elde edilenden ayırt edebilirsiniz. graphify query "<question>" düz dilde bir soru için kapsamlı bir alt grafik döndürür ve graphify path A B herhangi iki şeyin nasıl bağlandığını izler.

Ne yapar¶

Kutudan çıktığı haliyle elde ettikleriniz:

[!TIP] Bunu birçok repoda veya bir monorepoda mı çalıştırıyorsunuz? Graphify Cloud bunu sürekli yapar ve ajan token harcamasını %80 azaltır; repolar arası bağlantılar, SDLC genelinde kod incelemesi, biçimsel doğrulama ve Sentry/Jira konektörleri ile birlikte. 14 günlük ücretsiz denemeyi başlatın →

Karşılaştırmalı değerlendirmeler: 0.497 recall@10, 0 LLM credits¶

Her sistem aynı koşum takımında, aynı model ve bütçelerle çalıştırıldı; ikinci bir yargıca karşı körlemesine doğrulanmış bir yargıç tarafından puanlandı (%90.6 uyum, Cohen kappa 0.81). Tüm sistem bazında tablolar, kod zekası sonucu ve yeniden üretme komutları: BENCHMARKS.md.

Belgeler¶

Tam kılavuzlar ve başvuru kaynakları docs.graphify.com adresinde:

• Hızlı başlangıç: ilk grafiğinizi oluşturun
• CLI başvurusu: her komut ve bayrak
• Daha iyi grafik soruları sorun: sorgulama kalıpları
• Yapılandırma: ortam değişkenleri ve ince ayar
• Desteklenen girdiler: diller ve dosya türleri
• Ekip iş akışları ve PR incelemesi
• Sorun giderme ve Nasıl çalışır

Ön koşullar¶

macOS hızlı kurulum (Homebrew):

brew install python@3.12 uv

Windows hızlı kurulum:

winget install astral-sh.uv

Ubuntu/Debian:

sudo apt install python3.12 python3-pip pipx
# or install uv:
curl -LsSf https://astral.sh/uv/install.sh | sh

Install¶

[!IMPORTANT] Resmi paket: PyPI paketi graphifyy'dir (çift y). PyPI'deki diğer graphify* paketleri bağlantılı değildir. CLI komutu yine de graphify'dır.

Resmi kaynak deposu Graphify-Labs/graphify adresindedir.

Bu README'nin en üstünde iki komutluk hızlı başlangıç yer alır. Bu bölüm kurulum yöntemlerini, proje kapsamlı kurulumları ve desteklenen her platformu kapsar.

Kurulum yöntemleri (birini seçin):

uv tool install graphifyy   # recommended, isolated env (if 'graphify' isn't found after, run: uv tool update-shell)
pipx install graphifyy      # alternative
pip install graphifyy       # may need PATH setup, see Troubleshooting below

Ardından bir kez graphify install çalıştırın. Hangi asistanı çalıştırdığınızı algılar ve beceriyi kaydeder, böylece asistan başına kurulum gerekmez. Yapay zeka asistanınızı açın ve /graphify . yazın

Beceriyi kullanıcı profiliniz yerine mevcut depoya kurmak için --project ekleyin:

graphify install --project
graphify install --project --platform codex

Proje kapsamlı kurulumlar mevcut dizinin altına yazar, örneğin .claude/skills/graphify/SKILL.md veya .agents/skills/graphify/SKILL.md (artı becerinin talep üzerine yüklediği bir references/ yan dosyası) ve işlenebilecek dosyalar için bir git add ipucu yazdırır. Proje kapsamlı kurulumları destekleyen platform bazlı komutlar aynı bayrağı kabul eder, örneğin graphify claude install --project veya graphify codex install --project.

[!TIP] command not found, Mac/Windows'ta bir pip sorunu, PowerShell tırnak işareti, uvx kullanımı, git-hook PATH tuhaflıkları veya katı moda mı takıldınız? Bkz. Kurulum ve Sorun giderme.

Asistanınızın grafiği her zaman kullanmasını sağlayın¶

Bir grafik oluşturduktan sonra bunu projenizde bir kez çalıştırın:

Projenizde bir kez graphify <platform> install çalıştırın, örneğin graphify claude install veya graphify codex install (ya da graphify install --platform <name>).

Bu, asistanınıza kod tabanı soruları için bilgi grafiğine başvurmasını ve tam raporu okumak ya da ham dosyalarda grep yapmak yerine graphify query "<question>" gibi kapsamlı sorguları tercih etmesini söyleyen küçük bir yapılandırma dosyası yazar.

• Hook platformları (Claude Code, Gemini CLI): bir hook, arama tarzı araç çağrılarından önce (ve Claude Code'da, kaynak dosyaları Read/Glob araçlarıyla tek tek okumadan önce) otomatik olarak tetiklenir ve asistanınızı grafik yoluna yönlendirir.
• Talimat-dosyası platformları (Codex, OpenCode, Cursor vb.): kalıcı talimat dosyaları (AGENTS.md, .cursor/rules/ vb.) aynı önce-sorgula rehberliğini sağlar.

GRAPH_REPORT.md geniş mimari inceleme için hâlâ kullanılabilir.

Her platformun tam olarak hangi dosyaları yazdığı (CodeBuddy'nin CODEBUDDY.md + PreToolUse hook'ları, Codex'in AGENTS.md'si, Kilo'nun yerel .kilo eklentisi, Cursor'un alwaysApply kuralı vb.) şurada ele alınır: Daima açık kurulum.

graphify'ı tüm platformlardan aynı anda kaldırmak için: graphify uninstall (graphify-out/ dizinini de silmek için --purge ekleyin). Veya platform bazlı komutu kullanın (ör. graphify claude uninstall).

CLI becerileri mi yoksa MCP talimatları mı?¶

graphify install tarafından kurulan talimatlar ve bir Graphify MCP bağlantısıyla sağlananlar, bir grafiği sorgulamanın farklı yollarını açıklar:

Her ikisi de geniş kaynak aramalarından önce kapsamlı grafik sorgularını teşvik eder. Asistanınızın gerçekten erişebildiği araçlara uyan talimatları seçin; hiçbir blok, asistanınızın talimat dosyaları için evrensel bir öncelik kuralı belirlemez. Her iki entegrasyonu da kullanıyorsanız, her birinin hangi grafiği sorguladığını belirleyin ve AGENTS.md içine iki koşulsuz talimat bloğu kopyalamak yerine bir birincil sorgu yolu seçin.

graphify install, yerel asistan entegrasyonunu kurar; bir MCP bağlantısı kurmaz. Bir MCP istemcisinin, bağlı sunucusunu kullanmak için yerel CLI sorguları çalıştırmasına gerek yoktur. Yerel olarak barındırılan bir sunucunun hâlâ kendi Graphify kurulumuna ve grafiğine ihtiyacı vardır; barındırılan bir bağlantı ise istemcinin çalışma dizininde bulunmayan bir grafiği sunabilir. Beklenen araçlar eksikse, diğer kurulumun talimatlarını birbirinin yerine kullanılabilir gibi değerlendirmek yerine ilgili CLI kurulumunu veya MCP bağlantısını kontrol edin.

Raporda neler var¶

GRAPH_REPORT.md, geniş mimari inceleme için tanrı düğümlerini, toplulukları ve anahtar yolları özetler. Grafiğin nasıl oluşturulduğu ve neler içerdiği: graphify nasıl çalışır.

Hangi dosyaları işler: ~40 languages¶

graphify, ~40 programlama dilini yerel olarak tree-sitter AST ile ayrıştırır ve belgeleri, PDF'leri, görselleri ve ses/videoyu isteğe bağlı bir anlamsal geçiş aracılığıyla eşler. Tam liste: Desteklenen girdiler.

Yaygın komutlar¶

/graphify .                        # build graph for current folder
/graphify ./docs --update          # re-extract only changed files
/graphify . --cluster-only         # rerun clustering without re-extracting
/graphify . --cluster-only --resolution 1.5      # more granular communities
/graphify . --cluster-only --exclude-hubs 99     # suppress utility super-hubs from god-node rankings
/graphify . --no-viz               # skip the HTML, just the report + JSON
/graphify . --wiki                 # build a markdown wiki from the graph
graphify export callflow-html      # Mermaid architecture/call-flow HTML (auto-regenerates on every git commit if hook is installed)

/graphify query "what connects auth to the database?"
/graphify path "UserService" "DatabasePool"
/graphify explain "RateLimiter"

/graphify add https://arxiv.org/abs/1706.03762   # fetch a paper and add it
/graphify add <youtube-url>                       # transcribe and add a video

graphify hook install              # auto-rebuild on commit + branch checkout (run `graphify update .` after `git pull`: see "Recommended workflow" below)
graphify merge-graphs a.json b.json              # combine two graphs

graphify prs                       # PR dashboard: CI state, review status, worktree mapping
graphify prs 42                    # deep dive on PR #42 with graph impact
graphify prs --triage              # AI ranks your review queue (uses whatever backend is configured)
graphify prs --conflicts           # PRs sharing graph communities: merge-order risk

Aşağıdaki tam komut başvurusuna bakın.

Dosyaları yoksayma¶

graphify, .gitignore dosyasına uyar ve --exclude kalıplarını ve proje .graphifyignore dosyasını destekler. Ayrıntılar: Yapılandırma.

Proje yapılandırması¶

Bir çalıştırmaya değil projeye ait olan ayarlar için tarama kökünde bir .graphifyrc oluşturun. Satır başına bir key=value; # ile başlayan satırlar yorumdur.

Belirsiz uzantılar. Bazı uzantılar farklı projelerde farklı diller anlamına gelir: .inc, pfSense'de PHP, bir Delphi ağacında Pascal, başka yerlerde SQL veya assembly'dir; .h, C veya C++'tır; .m, Objective-C veya MATLAB'dır. graphify'ın tek bir küresel varsayılan seçmesi gerekir ve yanlış seçtiğinde dosya başarısız olmaz: yanlış dil olarak ayrıştırılır ve bir avuç tesadüfi düğüm üretir, böylece gerçek semboller eksikken grafik dolu görünür. Uzantının reponuzda ne anlama geldiğini bildirin:

# .graphifyrc
# A language name:
language.inc=php
# Or an extension graphify already knows:
language.tpl=.ts
# Baked into the git hooks (see Team setup):
viz_node_limit=0

Bildirim; sınıflandırma, çıkarıcı seçimi, dilbilgisi ve çözümleme, içe aktarmalar, graphify watch ve AST önbelleği boyunca akar (farklı bir dil altında yeniden ayrıştırılan bir dosya asla eski girişi yeniden kullanmaz) ve aynı .graphifyrc, extract, update, hook'lar, MCP sunucusu ve /graphify becerisi tarafından okunur. Bir yazım hatası stderr'de bir kez bildirilir ve tarama varsayılanlarla devam eder. Bildirimlerin önbellekleme, artımlı yeniden oluşturmalar ve içe aktarma çözümlemesiyle nasıl etkileştiği: Yapılandırma.

Ekip kurulumu¶

Tüm ekibinizin aynı bağlamı sorgulaması için grafiği işleyin veya paylaşın ve çekme isteklerini grafik bağlamıyla inceleyin. Bkz. Ekibinizle bağlam paylaşın ve Çekme isteklerini inceleyin.

Grafiği doğrudan kullanma¶

Yapay zeka asistanınızın ötesinde, graph.json dosyasını CLI'den doğrudan graphify query, graphify path ve graphify explain ile sorgulayın. Birden fazla düğümle eşleşen bir ad, tahmin edilmek yerine adaylar listelenerek reddedilir. Komut dosyaları sonucu çıkış kodundan okuyabilir: 0 bir yanıt, 3 belirsiz bir ad, 4 eşleşen düğüm yok. Bkz. Daha iyi grafik soruları sorun ve sorgu başvurusu.

Ortam değişkenleri¶

Arka uçlar, API anahtarları, hook davranışı ve ince ayar, ortam değişkenleriyle kontrol edilir. Tam tablo: Yapılandırma.

Gizlilik¶

• Kod dosyaları: tree-sitter ile yerel olarak işlenir. Hiçbir şey makinenizden çıkmaz. Yalnızca koddan oluşan bir derlem API anahtarı gerektirmez: graphify extract tamamen çevrimdışı çalışır. Karışık bir repoda, yalnızca kodu dizinlemek ve aksi takdirde bir LLM gerektirecek belgeleri/PDF'leri/görselleri atlamak için --code-only ekleyin.
• Video / ses: faster-whisper ile yerel olarak yazıya dökülür. Hiçbir şey makinenizden çıkmaz.
• Belgeler, PDF'ler, görseller: anlamsal çıkarım için yapay zeka asistanınıza gönderilir (/graphify becerisi aracılığıyla, IDE oturumunuzun çalıştırdığı modeli kullanarak). Başsız (headless) graphify extract, GEMINI_API_KEY / GOOGLE_API_KEY (Gemini), MOONSHOT_API_KEY (Kimi), ANTHROPIC_API_KEY (Claude), OPENAI_API_KEY (OpenAI), DEEPSEEK_API_KEY (DeepSeek), çalışan bir Ollama örneği (OLLAMA_BASE_URL), standart sağlayıcı zinciri üzerinden AWS kimlik bilgileri (Bedrock - API anahtarı gerekmez, IAM kullanır) veya claude CLI ikili dosyası (Claude Code - API anahtarı gerekmez, Claude aboneliğinizi kullanır) gerektirir. --dedup-llm bayrağı aynı anahtarı kullanır.
• Veri ikametgahı: graphify extract, hangi API anahtarının ayarlandığına bağlı olarak hangi sağlayıcının kullanılacağını otomatik olarak algılar (öncelik: Gemini → Kimi → Claude → OpenAI → DeepSeek → Azure → Bedrock → Ollama). Veri ikametgahı gereksinimleri olan kod için --backend ollama (tamamen yerel) kullanın veya açık bir --backend bayrağı geçirin. Kimi (MOONSHOT_API_KEY), Çin'deki Moonshot AI sunucularına yönlendirir.
• Telemetri yok, kullanım takibi yok, analitik yok.
• Sorgu günlüğü: her graphify query, graphify path, graphify explain ve MCP query_graph çağrısı, JSON Lines biçiminde ~/.cache/graphify-queries.log dosyasına kaydedilir (zaman damgası, soru, derlem, döndürülen düğümler, süre). Tam alt grafik yanıtları varsayılan olarak saklanmaz. Devre dışı bırakmak için GRAPHIFY_QUERY_LOG_DISABLE=1 ayarlayın veya kod yolunu devre dışı bırakmadan susturmak için GRAPHIFY_QUERY_LOG=/dev/null ayarlayın.

Sorun giderme¶

Yaygın kurulum ve çıkarım sorunları ve bunların çözümleri: Sorun giderme.

Tam komut başvurusu¶

Örneklerle birlikte her komut ve bayrak: CLI başvurusu.

Daha fazla bilgi¶

• docs.graphify.com: tam belgeler: kılavuzlar, komut başvurusu ve entegrasyonlar
• Nasıl çalışır: çıkarım hattı, topluluk tespiti, güven puanlaması, karşılaştırmalar
• ARCHITECTURE.md: modül dökümü, bir dilin nasıl ekleneceği
• İsteğe bağlı entegrasyonlar: Docker MCP Toolkit + SQLite
• The Memory Layer: graphify'ın ardındaki fikirleri ve mimariyi uçtan uca anlatan kitap

Graphify Cloud¶

Graphify Cloud, graphify'ın üzerine inşa edilmiş daima açık katmandır. Her klasör için talep üzerine yeniden oluşturduğunuz bir grafik yerine, tüm yazılım geliştirme yaşam döngünüz boyunca tek bir canlı grafiği korur:

• %80 daha az token: daima açık bellek, ajanlarınızın her oturumda kod tabanını yeniden okumayı ve yeniden açıklamayı bırakması demektir.
• Monorepo ve repolar arası: her hizmet ve depo genelinde tek bir bağlı grafik, klasör başına bir grafik değil.
• Biçimsel doğrulama: mimari ve bağımlılık değişmezlerini canlı grafiğe göre kontrol edin.
• SDLC'nize kuşbakışı bakışla kod incelemesi: birleştirmeden önce bir değişikliğin tüm sisteme nasıl yayıldığını görün.
• SDLC konektörleri: Sentry, Jira ve daha fazlasını çekin; böylece olaylar, biletler ve kod tek bir grafikte yaşar.
• Daima açık: kod, belgeler ve toplantılar genelinde arka planda sürekli güncellenir.

app.graphify.com'da 14 günlük ücretsiz denemeyi başlatın →

Katkıda bulunma¶

Katkılar memnuniyetle karşılanır. Geliştirme kurulumu, test ve CI eşitlik komutları, git iş akışı ve güçlü bir katkıyı neyin oluşturduğu (işlenmiş örnekler ve çıkarım hata raporları en yararlı olanlardır) için CONTRIBUTING.md dosyasına bakın. Mimari ve bir dilin nasıl ekleneceği: ARCHITECTURE.md.

Buraya yeni mi geldiniz? Discord üzerinde veya GitHub Discussions içinde selam verin.

Katkıda bulunanlar¶

contrib.rocks ile yapılmıştır.

Çeviriler¶

README 32 dilde mevcuttur. Kendi dilinizde okumak için bu dosyanın en üstündeki dil değiştiriciyi kullanın veya docs/translations/ dizinine göz atın. Bir çeviriyi iyileştirmek veya yenisini eklemek için oradaki ilgili dosyaya karşı bir çekme isteği açın.

graphify üzerine inşa etme¶

graphify ekosisteminde bir şeyler mi inşa ediyorsunuz? Buna teşvik ediliyor. Projeniz adında "graphify" kullanıyorsa (örneğin graphify-dashboard veya graphify-action), lütfen README dosyanıza bunun topluluk tarafından oluşturulduğunu ve Graphify Labs ile bağlantılı olmadığını ya da onun tarafından onaylanmadığını açıklayan kısa bir not ekleyin. "graphify" ve graphify logosu, Graphify Labs'ın markalarıdır; lütfen bunları resmi bir statüyü ima edecek şekilde kullanmayın.

Topluluk ve bağlantılar¶