diff --git a/README.ar-SA.md b/README.ar-SA.md
new file mode 100644
index 00000000..9b4c9ba1
--- /dev/null
+++ b/README.ar-SA.md
@@ -0,0 +1,177 @@
+
+ 
+
+
+
+ English | 简体中文 | 日本語 | 한국어 | Deutsch | Français | Español | हिन्दी | Português | Русский | العربية
+
+
+
+ 
+ 
+ 
+ 
+ 
+
+
+
+
+**مهارة لمساعد برمجة الذكاء الاصطناعي.** اكتب `/graphify` في Claude Code أو Codex أو OpenCode أو Cursor أو Gemini CLI أو GitHub Copilot CLI أو VS Code Copilot Chat أو Aider أو OpenClaw أو Factory Droid أو Trae أو Hermes أو Kiro أو Google Antigravity — يقرأ ملفاتك ويبني رسماً بيانياً للمعرفة ويعيد إليك البنية التي لم تكن تعلم بوجودها. افهم قاعدة الكود بشكل أسرع. اكتشف "السبب" وراء القرارات المعمارية.
+
+متعدد الوسائط بالكامل. أضف كوداً أو ملفات PDF أو markdown أو لقطات شاشة أو رسوماً بيانية أو صور سبورة أو صوراً بلغات أخرى أو ملفات فيديو وصوت — يستخرج graphify المفاهيم والعلاقات من كل ذلك ويربطها في رسم بياني واحد. يتم نسخ مقاطع الفيديو محلياً باستخدام Whisper. يدعم 25 لغة برمجة عبر tree-sitter AST (Python, JS, TS, Go, Rust, Java, C, C++, Ruby, C#, Kotlin, Scala, PHP, Swift, Lua, Zig, PowerShell, Elixir, Objective-C, Julia, Verilog, SystemVerilog, Vue, Svelte, Dart).
+
+> يحتفظ Andrej Karpathy بمجلد `/raw` يضع فيه الأوراق البحثية والتغريدات ولقطات الشاشة والملاحظات. graphify هو الإجابة على تلك المشكلة — **71.5 مرة** أقل في الرموز لكل استعلام مقارنةً بقراءة الملفات الخام، مستمر عبر الجلسات، صادق حول ما تم العثور عليه مقابل ما تم استنتاجه.
+
+
+
+```
+/graphify . # يعمل مع أي مجلد — الكود، الملاحظات، الأوراق البحثية، كل شيء
+```
+
+```
+graphify-out/
+├── graph.html رسم بياني تفاعلي — افتحه في أي متصفح، انقر على العقد، ابحث، صفّ
+├── GRAPH_REPORT.md عقد الإله، الاتصالات المفاجئة، الأسئلة المقترحة
+├── graph.json رسم بياني دائم — استعلم بعد أسابيع دون إعادة القراءة
+└── cache/ ذاكرة تخزين مؤقت SHA256 — إعادة التشغيل تعالج الملفات المتغيرة فقط
+```
+
+
+
+أضف ملف `.graphifyignore` لاستبعاد المجلدات:
+
+
+
+```
+# .graphifyignore
+vendor/
+node_modules/
+dist/
+*.generated.py
+```
+
+
+
+نفس صيغة `.gitignore`.
+
+## كيف يعمل
+
+يعمل graphify في ثلاث مراحل. أولاً، تمريرة AST حتمية تستخرج البنية من ملفات الكود (الفئات، الدوال، الاستيرادات، رسوم بيانية الاستدعاء، docstrings، تعليقات المبرر) — دون الحاجة إلى LLM. ثانياً، يتم نسخ ملفات الفيديو والصوت محلياً باستخدام faster-whisper. ثالثاً، تعمل عوامل Claude الفرعية بالتوازي على المستندات والأوراق البحثية والصور والنصوص المكتوبة لاستخراج المفاهيم والعلاقات ومبررات التصميم. يتم دمج النتائج في رسم بياني NetworkX وتجميعها باستخدام Leiden وتصديرها كـ HTML تفاعلي وJSON قابل للاستعلام وتقرير تدقيق بلغة طبيعية.
+
+**التجميع مبني على طوبولوجيا الرسم البياني — بدون embeddings.** يجد Leiden المجتمعات بواسطة كثافة الحواف. حواف التشابه الدلالي التي يستخرجها Claude (`semantically_similar_to`، مصنفة INFERRED) موجودة بالفعل في الرسم البياني. بنية الرسم البياني هي إشارة التشابه — لا حاجة لخطوة embedding منفصلة أو قاعدة بيانات متجهية.
+
+كل علاقة مصنفة كـ `EXTRACTED` (وجدت مباشرة في المصدر) أو `INFERRED` (استنتاج معقول مع درجة ثقة) أو `AMBIGUOUS` (مُعلَّمة للمراجعة).
+
+## التثبيت
+
+**المتطلبات:** Python 3.10+ وواحد من: [Claude Code](https://claude.ai/code), [Codex](https://openai.com/codex), [OpenCode](https://opencode.ai), [Cursor](https://cursor.com), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli), [VS Code Copilot Chat](https://code.visualstudio.com/docs/copilot/overview), [Aider](https://aider.chat), [OpenClaw](https://openclaw.ai), [Factory Droid](https://factory.ai), [Trae](https://trae.ai), [Kiro](https://kiro.dev), Hermes, أو [Google Antigravity](https://antigravity.google)
+
+
+
+```bash
+# موصى به — يعمل على Mac وLinux دون إعداد PATH
+uv tool install graphifyy && graphify install
+# أو مع pipx
+pipx install graphifyy && graphify install
+# أو pip العادي
+pip install graphifyy && graphify install
+```
+
+
+
+> **الحزمة الرسمية:** اسم حزمة PyPI هو `graphifyy` (تثبيت بـ `pip install graphifyy`). الحزم الأخرى المسماة `graphify*` على PyPI ليست تابعة لهذا المشروع. المستودع الرسمي الوحيد هو [safishamsi/graphify](https://github.com/safishamsi/graphify).
+
+### دعم المنصات
+
+| المنصة | أمر التثبيت |
+|--------|-------------|
+| Claude Code (Linux/Mac) | `graphify install` |
+| Claude Code (Windows) | `graphify install` (كشف تلقائي) أو `graphify install --platform windows` |
+| Codex | `graphify install --platform codex` |
+| OpenCode | `graphify install --platform opencode` |
+| GitHub Copilot CLI | `graphify install --platform copilot` |
+| VS Code Copilot Chat | `graphify vscode install` |
+| Aider | `graphify install --platform aider` |
+| OpenClaw | `graphify install --platform claw` |
+| Factory Droid | `graphify install --platform droid` |
+| Trae | `graphify install --platform trae` |
+| Gemini CLI | `graphify install --platform gemini` |
+| Hermes | `graphify install --platform hermes` |
+| Kiro IDE/CLI | `graphify kiro install` |
+| Cursor | `graphify cursor install` |
+| Google Antigravity | `graphify antigravity install` |
+
+افتح مساعد الكود الذكاء الاصطناعي واكتب:
+
+
+
+```
+/graphify .
+```
+
+
+
+ملاحظة: يستخدم Codex `$` بدلاً من `/` للمهارات، لذا اكتب `$graphify .`.
+
+## الاستخدام
+
+
+
+```
+/graphify # المجلد الحالي
+/graphify ./raw # مجلد محدد
+/graphify ./raw --update # إعادة استخراج الملفات المتغيرة فقط
+/graphify ./raw --directed # رسم بياني موجّه
+/graphify ./raw --no-viz # تقرير + JSON فقط، بدون HTML
+/graphify ./raw --obsidian # إنشاء Obsidian vault
+
+/graphify add https://arxiv.org/abs/1706.03762 # جلب ورقة بحثية
+/graphify add # تحميل صوت، نسخ، إضافة
+/graphify query "ما الذي يربط Attention بالمحسِّن؟"
+/graphify path "DigestAuth" "Response"
+/graphify explain "SwinTransformer"
+
+graphify hook install # تثبيت Git hooks
+graphify update ./src # إعادة استخراج ملفات الكود، بدون LLM
+graphify watch ./src # تحديث تلقائي للرسم البياني
+```
+
+
+
+## ما ستحصل عليه
+
+**عقد الإله** — المفاهيم ذات أعلى درجة (كل شيء يمر بها)
+
+**الاتصالات المفاجئة** — مرتبة حسب الدرجة المركبة. حواف الكود-الورقة البحثية تحصل على تصنيف أعلى. كل نتيجة تتضمن سبباً بلغة طبيعية.
+
+**الأسئلة المقترحة** — 4-5 أسئلة الرسم البياني في وضع فريد للإجابة عليها
+
+**"السبب"** — يتم استخراج docstrings والتعليقات المضمنة (`# NOTE:`, `# IMPORTANT:`, `# HACK:`, `# WHY:`) ومبررات التصميم كعقد `rationale_for`.
+
+**درجات الثقة** — كل حافة INFERRED لها `confidence_score` (0.0-1.0).
+
+**معيار الرموز** — يُطبع تلقائياً بعد كل تشغيل. على مجموعة بيانات مختلطة: **71.5 مرة** أقل في الرموز لكل استعلام مقارنةً بالملفات الخام.
+
+**المزامنة التلقائية** (`--watch`) — يحدّث الرسم البياني تلقائياً عند تغيير الكود.
+
+**Git hooks** (`graphify hook install`) — يثبّت خطافات post-commit وpost-checkout.
+
+## الخصوصية
+
+يرسل graphify محتوى الملفات إلى API نموذج مساعد الذكاء الاصطناعي الخاص بك للاستخراج الدلالي من المستندات والأوراق البحثية والصور. تتم معالجة ملفات الكود محلياً عبر tree-sitter AST. يتم نسخ ملفات الفيديو والصوت محلياً باستخدام faster-whisper. لا قياس عن بُعد، لا تتبع للاستخدام.
+
+## المكدس التقني
+
+NetworkX + Leiden (graspologic) + tree-sitter + vis.js. استخراج دلالي عبر Claude أو GPT-4 أو نموذج منصتك. نسخ الفيديو عبر faster-whisper + yt-dlp (اختياري).
+
+## مبني على graphify — Penpax
+
+[**Penpax**](https://safishamsi.github.io/penpax.ai) هو الطبقة المؤسسية فوق graphify. حيث يحوّل graphify مجلداً من الملفات إلى رسم بياني للمعرفة، يطبّق Penpax نفس الرسم البياني على حياتك المهنية بأكملها — باستمرار.
+
+**نسخة تجريبية مجانية قريباً.** [انضم إلى قائمة الانتظار →](https://safishamsi.github.io/penpax.ai)
+
+## سجل النجوم
+
+
+
+[](https://star-history.com/#safishamsi/graphify&Date)
diff --git a/README.de-DE.md b/README.de-DE.md
new file mode 100644
index 00000000..e3f4383e
--- /dev/null
+++ b/README.de-DE.md
@@ -0,0 +1,180 @@
+
+
+
+
+
+ English | 简体中文 | 日本語 | 한국어 | Deutsch | Français | Español | हिन्दी | Português | Русский | العربية
+
+
+
+
+
+
+
+
+
+
+**Eine KI-Coding-Assistent-Skill.** Tippe `/graphify` in Claude Code, Codex, OpenCode, Cursor, Gemini CLI, GitHub Copilot CLI, VS Code Copilot Chat, Aider, OpenClaw, Factory Droid, Trae, Hermes, Kiro oder Google Antigravity — es liest deine Dateien, baut einen Wissensgraphen und gibt dir Struktur zurück, die du vorher nicht sehen konntest. Verstehe eine Codebasis schneller. Finde das „Warum" hinter Architekturentscheidungen.
+
+Vollständig multimodal. Leg Code, PDFs, Markdown, Screenshots, Diagramme, Whiteboard-Fotos, Bilder in anderen Sprachen oder Video- und Audiodateien ab — graphify extrahiert Konzepte und Beziehungen aus allem und verbindet sie in einem einzigen Graphen. Videos werden lokal mit Whisper transkribiert, angetrieben durch einen domänenspezifischen Prompt aus deinem Korpus. 25 Programmiersprachen werden über tree-sitter AST unterstützt (Python, JS, TS, Go, Rust, Java, C, C++, Ruby, C#, Kotlin, Scala, PHP, Swift, Lua, Zig, PowerShell, Elixir, Objective-C, Julia, Verilog, SystemVerilog, Vue, Svelte, Dart).
+
+> Andrej Karpathy führt einen `/raw`-Ordner, in dem er Papers, Tweets, Screenshots und Notizen ablegt. graphify ist die Antwort auf dieses Problem — 71,5-fach weniger Tokens pro Abfrage gegenüber dem Lesen der Rohdateien, persistent über Sitzungen hinweg, ehrlich darüber, was gefunden vs. erschlossen wurde.
+
+```
+/graphify . # funktioniert mit jedem Ordner — Codebase, Notizen, Papers, alles
+```
+
+```
+graphify-out/
+├── graph.html interaktiver Graph — im Browser öffnen, Knoten anklicken, suchen, filtern
+├── GRAPH_REPORT.md Gott-Knoten, überraschende Verbindungen, vorgeschlagene Fragen
+├── graph.json persistenter Graph — Wochen später abfragen, ohne neu zu lesen
+└── cache/ SHA256-Cache — erneute Ausführungen verarbeiten nur geänderte Dateien
+```
+
+Füge eine `.graphifyignore`-Datei hinzu, um Ordner auszuschließen:
+
+```
+# .graphifyignore
+vendor/
+node_modules/
+dist/
+*.generated.py
+```
+
+Gleiche Syntax wie `.gitignore`. Du kannst eine einzelne `.graphifyignore` im Repo-Stammverzeichnis behalten — Muster funktionieren korrekt, auch wenn graphify auf einem Unterordner ausgeführt wird.
+
+## So funktioniert es
+
+graphify läuft in drei Durchgängen. Zuerst extrahiert ein deterministischer AST-Durchgang Strukturen aus Code-Dateien (Klassen, Funktionen, Importe, Aufrufgraphen, Docstrings, Begründungskommentare) — ohne LLM. Zweitens werden Video- und Audiodateien lokal mit faster-whisper transkribiert, angetrieben durch einen domänenspezifischen Prompt aus Korpus-Gott-Knoten — Transkripte werden gecacht, sodass erneute Ausführungen sofort sind. Drittens laufen Claude-Subagenten parallel über Dokumente, Papers, Bilder und Transkripte, um Konzepte, Beziehungen und Designbegründungen zu extrahieren. Die Ergebnisse werden in einem NetworkX-Graphen zusammengeführt, mit Leiden-Community-Erkennung geclustert und als interaktives HTML, abfragbares JSON und ein Klartext-Audit-Report exportiert.
+
+**Clustering basiert auf Graph-Topologie — keine Embeddings.** Leiden findet Communities durch Kantendichte. Die semantischen Ähnlichkeitskanten, die Claude extrahiert (`semantically_similar_to`, markiert als INFERRED), sind bereits im Graphen, sodass sie die Community-Erkennung direkt beeinflussen. Die Graphstruktur ist das Ähnlichkeitssignal — kein separater Embedding-Schritt oder Vektordatenbank nötig.
+
+Jede Beziehung ist markiert als `EXTRACTED` (direkt in der Quelle gefunden), `INFERRED` (begründete Schlussfolgerung mit Konfidenzwert) oder `AMBIGUOUS` (zur Überprüfung markiert). Du weißt immer, was gefunden vs. erschlossen wurde.
+
+## Installation
+
+**Voraussetzungen:** Python 3.10+ und eines von: [Claude Code](https://claude.ai/code), [Codex](https://openai.com/codex), [OpenCode](https://opencode.ai), [Cursor](https://cursor.com), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli), [VS Code Copilot Chat](https://code.visualstudio.com/docs/copilot/overview), [Aider](https://aider.chat), [OpenClaw](https://openclaw.ai), [Factory Droid](https://factory.ai), [Trae](https://trae.ai), [Kiro](https://kiro.dev), Hermes oder [Google Antigravity](https://antigravity.google)
+
+```bash
+# Empfohlen — funktioniert auf Mac und Linux ohne PATH-Einrichtung
+uv tool install graphifyy && graphify install
+# oder mit pipx
+pipx install graphifyy && graphify install
+# oder einfaches pip
+pip install graphifyy && graphify install
+```
+
+> **Offizielles Paket:** Das PyPI-Paket heißt `graphifyy` (installieren mit `pip install graphifyy`). Andere Pakete mit Namen `graphify*` auf PyPI sind nicht mit diesem Projekt verbunden. Das einzige offizielle Repository ist [safishamsi/graphify](https://github.com/safishamsi/graphify). CLI und Skill-Befehl heißen weiterhin `graphify`.
+
+> **`graphify: command not found`?** Verwende `uv tool install graphifyy` (empfohlen) oder `pipx install graphifyy` — beide platzieren die CLI an einem verwalteten Ort, der automatisch im PATH ist. Mit einfachem `pip` musst du möglicherweise `~/.local/bin` (Linux) oder `~/Library/Python/3.x/bin` (Mac) zum PATH hinzufügen, oder `python -m graphify` verwenden.
+
+### Plattformunterstützung
+
+| Plattform | Installationsbefehl |
+|-----------|---------------------|
+| Claude Code (Linux/Mac) | `graphify install` |
+| Claude Code (Windows) | `graphify install` (automatisch erkannt) oder `graphify install --platform windows` |
+| Codex | `graphify install --platform codex` |
+| OpenCode | `graphify install --platform opencode` |
+| GitHub Copilot CLI | `graphify install --platform copilot` |
+| VS Code Copilot Chat | `graphify vscode install` |
+| Aider | `graphify install --platform aider` |
+| OpenClaw | `graphify install --platform claw` |
+| Factory Droid | `graphify install --platform droid` |
+| Trae | `graphify install --platform trae` |
+| Trae CN | `graphify install --platform trae-cn` |
+| Gemini CLI | `graphify install --platform gemini` |
+| Hermes | `graphify install --platform hermes` |
+| Kiro IDE/CLI | `graphify kiro install` |
+| Cursor | `graphify cursor install` |
+| Google Antigravity | `graphify antigravity install` |
+
+Dann öffne deinen KI-Coding-Assistenten und tippe:
+
+```
+/graphify .
+```
+
+Hinweis: Codex verwendet `$` statt `/` für Skill-Aufrufe, also tippe `$graphify .`.
+
+### Assistenten immer den Graphen nutzen lassen (empfohlen)
+
+Nach dem Erstellen eines Graphen, führe dies einmal in deinem Projekt aus:
+
+| Plattform | Befehl |
+|-----------|--------|
+| Claude Code | `graphify claude install` |
+| Codex | `graphify codex install` |
+| OpenCode | `graphify opencode install` |
+| GitHub Copilot CLI | `graphify copilot install` |
+| VS Code Copilot Chat | `graphify vscode install` |
+| Aider | `graphify aider install` |
+| OpenClaw | `graphify claw install` |
+| Factory Droid | `graphify droid install` |
+| Trae | `graphify trae install` |
+| Trae CN | `graphify trae-cn install` |
+| Cursor | `graphify cursor install` |
+| Gemini CLI | `graphify gemini install` |
+| Hermes | `graphify hermes install` |
+| Kiro IDE/CLI | `graphify kiro install` |
+| Google Antigravity | `graphify antigravity install` |
+
+## Verwendung
+
+```
+/graphify # aktuelles Verzeichnis verarbeiten
+/graphify ./raw # spezifischen Ordner verarbeiten
+/graphify ./raw --mode deep # aggressivere INFERRED-Kanten-Extraktion
+/graphify ./raw --update # nur geänderte Dateien neu extrahieren
+/graphify ./raw --directed # gerichteten Graphen erstellen
+/graphify ./raw --cluster-only # Clustering auf bestehendem Graphen neu ausführen
+/graphify ./raw --no-viz # kein HTML, nur Report + JSON
+/graphify ./raw --obsidian # Obsidian-Vault generieren (opt-in)
+
+/graphify add https://arxiv.org/abs/1706.03762 # Paper abrufen, speichern, Graphen aktualisieren
+/graphify add # Audio herunterladen, transkribieren, hinzufügen
+/graphify query "was verbindet Attention mit dem Optimizer?"
+/graphify path "DigestAuth" "Response"
+/graphify explain "SwinTransformer"
+
+graphify hook install # Git-Hooks installieren
+graphify update ./src # Code-Dateien neu extrahieren, kein LLM benötigt
+graphify watch ./src # Graphen bei Änderungen automatisch aktualisieren
+```
+
+## Was du bekommst
+
+**Gott-Knoten** — Konzepte mit dem höchsten Grad (durch die alles fließt)
+
+**Überraschende Verbindungen** — nach Composite-Score eingestuft. Code-Paper-Kanten werden höher bewertet. Jedes Ergebnis enthält ein Klartext-Warum.
+
+**Vorgeschlagene Fragen** — 4-5 Fragen, die der Graph einzigartig gut beantworten kann
+
+**Das „Warum"** — Docstrings, Inline-Kommentare (`# NOTE:`, `# IMPORTANT:`, `# HACK:`, `# WHY:`), und Designbegründungen aus Dokumenten werden als `rationale_for`-Knoten extrahiert.
+
+**Konfidenzwerte** — jede INFERRED-Kante hat einen `confidence_score` (0,0-1,0).
+
+**Token-Benchmark** — wird automatisch nach jeder Ausführung gedruckt. Auf einem gemischten Korpus: **71,5-fach** weniger Tokens pro Abfrage gegenüber Rohdateien.
+
+**Auto-Sync** (`--watch`) — läuft im Hintergrund und aktualisiert den Graphen bei Codeänderungen automatisch.
+
+**Git-Hooks** (`graphify hook install`) — installiert Post-Commit- und Post-Checkout-Hooks.
+
+## Datenschutz
+
+graphify sendet Dateiinhalte an die Modell-API deines KI-Assistenten für semantische Extraktion von Dokumenten, Papers und Bildern. Code-Dateien werden lokal via tree-sitter AST verarbeitet — kein Dateiinhalt verlässt dein Gerät für Code. Video- und Audiodateien werden lokal mit faster-whisper transkribiert. Keine Telemetrie, keine Nutzungsverfolgung.
+
+## Tech-Stack
+
+NetworkX + Leiden (graspologic) + tree-sitter + vis.js. Semantische Extraktion via Claude, GPT-4 oder welches Modell deine Plattform verwendet. Video-Transkription via faster-whisper + yt-dlp (optional).
+
+## Auf graphify aufgebaut — Penpax
+
+[**Penpax**](https://safishamsi.github.io/penpax.ai) ist die Enterprise-Schicht über graphify. Wo graphify einen Ordner mit Dateien in einen Wissensgraphen verwandelt, wendet Penpax denselben Graphen auf dein gesamtes Arbeitsleben an — kontinuierlich.
+
+**Kostenlose Testversion startet bald.** [Auf die Warteliste setzen →](https://safishamsi.github.io/penpax.ai)
+
+## Star-Verlauf
+
+[](https://star-history.com/#safishamsi/graphify&Date)
diff --git a/README.es-ES.md b/README.es-ES.md
new file mode 100644
index 00000000..9489a87d
--- /dev/null
+++ b/README.es-ES.md
@@ -0,0 +1,170 @@
+
+
+
+
+
+ English | 简体中文 | 日本語 | 한국어 | Deutsch | Français | Español | हिन्दी | Português | Русский | العربية
+
+
+
+
+
+
+
+
+
+
+**Una habilidad para asistentes de código IA.** Escribe `/graphify` en Claude Code, Codex, OpenCode, Cursor, Gemini CLI, GitHub Copilot CLI, VS Code Copilot Chat, Aider, OpenClaw, Factory Droid, Trae, Hermes, Kiro o Google Antigravity — lee tus archivos, construye un grafo de conocimiento y te devuelve estructura que no sabías que existía. Entiende una base de código más rápido. Encuentra el «por qué» detrás de las decisiones arquitectónicas.
+
+Totalmente multimodal. Deposita código, PDFs, markdown, capturas de pantalla, diagramas, fotos de pizarras, imágenes en otros idiomas, o archivos de video y audio — graphify extrae conceptos y relaciones de todo ello y los conecta en un solo grafo. Los videos se transcriben localmente con Whisper usando un prompt adaptado al dominio derivado de tu corpus. 25 lenguajes de programación soportados mediante tree-sitter AST (Python, JS, TS, Go, Rust, Java, C, C++, Ruby, C#, Kotlin, Scala, PHP, Swift, Lua, Zig, PowerShell, Elixir, Objective-C, Julia, Verilog, SystemVerilog, Vue, Svelte, Dart).
+
+> Andrej Karpathy mantiene una carpeta `/raw` donde deposita papers, tweets, capturas de pantalla y notas. graphify es la respuesta a ese problema — 71,5 veces menos tokens por consulta versus leer los archivos sin procesar, persistente entre sesiones, honesto sobre lo que encontró versus lo que infirió.
+
+```
+/graphify . # funciona con cualquier carpeta — tu código, notas, papers, todo
+```
+
+```
+graphify-out/
+├── graph.html grafo interactivo — abrir en cualquier navegador, hacer clic en nodos, buscar
+├── GRAPH_REPORT.md nodos dios, conexiones sorprendentes, preguntas sugeridas
+├── graph.json grafo persistente — consultar semanas después sin releer
+└── cache/ caché SHA256 — las re-ejecuciones solo procesan archivos modificados
+```
+
+Añade un archivo `.graphifyignore` para excluir carpetas:
+
+```
+# .graphifyignore
+vendor/
+node_modules/
+dist/
+*.generated.py
+```
+
+Misma sintaxis que `.gitignore`. Puedes mantener un único `.graphifyignore` en la raíz del repositorio.
+
+## Cómo funciona
+
+graphify se ejecuta en tres pasadas. Primero, una pasada AST determinista extrae estructura de los archivos de código (clases, funciones, importaciones, grafos de llamadas, docstrings, comentarios de justificación) sin necesidad de LLM. Segundo, los archivos de video y audio se transcriben localmente con faster-whisper usando un prompt adaptado al dominio derivado de los nodos dios del corpus. Tercero, subagentes de Claude se ejecutan en paralelo sobre documentos, papers, imágenes y transcripciones para extraer conceptos, relaciones y justificaciones de diseño. Los resultados se fusionan en un grafo NetworkX, se agrupan con detección de comunidades Leiden, y se exportan como HTML interactivo, JSON consultable y un informe de auditoría en lenguaje natural.
+
+**El clustering se basa en la topología del grafo — sin embeddings.** Leiden encuentra comunidades por densidad de aristas. Las aristas de similitud semántica que Claude extrae (`semantically_similar_to`, marcadas como INFERRED) ya están en el grafo. La estructura del grafo es la señal de similitud — no se necesita paso de embedding separado ni base de datos vectorial.
+
+Cada relación está etiquetada como `EXTRACTED` (encontrada directamente en la fuente), `INFERRED` (inferencia razonable con puntuación de confianza) o `AMBIGUOUS` (marcada para revisión).
+
+## Instalación
+
+**Requisitos:** Python 3.10+ y uno de: [Claude Code](https://claude.ai/code), [Codex](https://openai.com/codex), [OpenCode](https://opencode.ai), [Cursor](https://cursor.com), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli), [VS Code Copilot Chat](https://code.visualstudio.com/docs/copilot/overview), [Aider](https://aider.chat), [OpenClaw](https://openclaw.ai), [Factory Droid](https://factory.ai), [Trae](https://trae.ai), [Kiro](https://kiro.dev), Hermes o [Google Antigravity](https://antigravity.google)
+
+```bash
+# Recomendado — funciona en Mac y Linux sin configurar el PATH
+uv tool install graphifyy && graphify install
+# o con pipx
+pipx install graphifyy && graphify install
+# o pip simple
+pip install graphifyy && graphify install
+```
+
+> **Paquete oficial:** El paquete PyPI se llama `graphifyy` (instalar con `pip install graphifyy`). Otros paquetes llamados `graphify*` en PyPI no están afiliados con este proyecto. El único repositorio oficial es [safishamsi/graphify](https://github.com/safishamsi/graphify).
+
+### Soporte de plataformas
+
+| Plataforma | Comando de instalación |
+|------------|------------------------|
+| Claude Code (Linux/Mac) | `graphify install` |
+| Claude Code (Windows) | `graphify install` (detección automática) o `graphify install --platform windows` |
+| Codex | `graphify install --platform codex` |
+| OpenCode | `graphify install --platform opencode` |
+| GitHub Copilot CLI | `graphify install --platform copilot` |
+| VS Code Copilot Chat | `graphify vscode install` |
+| Aider | `graphify install --platform aider` |
+| OpenClaw | `graphify install --platform claw` |
+| Factory Droid | `graphify install --platform droid` |
+| Trae | `graphify install --platform trae` |
+| Trae CN | `graphify install --platform trae-cn` |
+| Gemini CLI | `graphify install --platform gemini` |
+| Hermes | `graphify install --platform hermes` |
+| Kiro IDE/CLI | `graphify kiro install` |
+| Cursor | `graphify cursor install` |
+| Google Antigravity | `graphify antigravity install` |
+
+Luego abre tu asistente de código IA y escribe:
+
+```
+/graphify .
+```
+
+Nota: Codex usa `$` en lugar de `/` para habilidades, así que escribe `$graphify .`.
+
+### Hacer que el asistente siempre use el grafo (recomendado)
+
+Después de construir un grafo, ejecuta esto una vez en tu proyecto:
+
+| Plataforma | Comando |
+|------------|---------|
+| Claude Code | `graphify claude install` |
+| Codex | `graphify codex install` |
+| OpenCode | `graphify opencode install` |
+| Cursor | `graphify cursor install` |
+| Gemini CLI | `graphify gemini install` |
+| Kiro IDE/CLI | `graphify kiro install` |
+| Google Antigravity | `graphify antigravity install` |
+
+## Uso
+
+```
+/graphify # directorio actual
+/graphify ./raw # carpeta específica
+/graphify ./raw --mode deep # extracción de aristas INFERRED más agresiva
+/graphify ./raw --update # re-extraer solo archivos modificados
+/graphify ./raw --directed # grafo dirigido
+/graphify ./raw --cluster-only # re-ejecutar clustering en grafo existente
+/graphify ./raw --no-viz # sin HTML, solo informe + JSON
+/graphify ./raw --obsidian # generar vault de Obsidian (opt-in)
+
+/graphify add https://arxiv.org/abs/1706.03762 # obtener un paper
+/graphify add # descargar audio, transcribir, añadir
+/graphify query "¿qué conecta Attention con el optimizador?"
+/graphify path "DigestAuth" "Response"
+/graphify explain "SwinTransformer"
+
+graphify hook install # instalar hooks de Git
+graphify update ./src # re-extraer archivos de código, sin LLM
+graphify watch ./src # actualización automática del grafo
+```
+
+## Qué obtienes
+
+**Nodos dios** — conceptos con mayor grado (por donde todo pasa)
+
+**Conexiones sorprendentes** — clasificadas por puntuación compuesta. Las aristas código-paper puntúan más alto. Cada resultado incluye un por qué en lenguaje natural.
+
+**Preguntas sugeridas** — 4-5 preguntas que el grafo está en posición única de responder
+
+**El «por qué»** — docstrings, comentarios inline (`# NOTE:`, `# IMPORTANT:`, `# HACK:`, `# WHY:`), y justificaciones de diseño extraídas como nodos `rationale_for`.
+
+**Puntuaciones de confianza** — cada arista INFERRED tiene un `confidence_score` (0,0-1,0).
+
+**Benchmark de tokens** — impreso automáticamente tras cada ejecución. En un corpus mixto: **71,5 veces** menos tokens por consulta vs archivos sin procesar.
+
+**Sincronización automática** (`--watch`) — actualiza el grafo automáticamente cuando cambia el código.
+
+**Hooks de Git** (`graphify hook install`) — instala hooks post-commit y post-checkout.
+
+## Privacidad
+
+graphify envía contenido de archivos a la API del modelo de tu asistente IA para extracción semántica de documentos, papers e imágenes. Los archivos de código se procesan localmente mediante tree-sitter AST. Los archivos de video y audio se transcriben localmente con faster-whisper. Sin telemetría, sin seguimiento de uso.
+
+## Stack técnico
+
+NetworkX + Leiden (graspologic) + tree-sitter + vis.js. Extracción semántica via Claude, GPT-4 o el modelo de tu plataforma. Transcripción de video via faster-whisper + yt-dlp (opcional).
+
+## Construido sobre graphify — Penpax
+
+[**Penpax**](https://safishamsi.github.io/penpax.ai) es la capa enterprise sobre graphify. Donde graphify convierte una carpeta de archivos en un grafo de conocimiento, Penpax aplica el mismo grafo a toda tu vida laboral — continuamente.
+
+**Prueba gratuita próximamente.** [Unirse a la lista de espera →](https://safishamsi.github.io/penpax.ai)
+
+## Historial de estrellas
+
+[](https://star-history.com/#safishamsi/graphify&Date)
diff --git a/README.fr-FR.md b/README.fr-FR.md
new file mode 100644
index 00000000..0ac09acd
--- /dev/null
+++ b/README.fr-FR.md
@@ -0,0 +1,170 @@
+
+
+
+
+
+ English | 简体中文 | 日本語 | 한국어 | Deutsch | Français | Español | हिन्दी | Português | Русский | العربية
+
+
+
+
+
+
+
+
+
+
+**Une compétence pour assistant de code IA.** Tapez `/graphify` dans Claude Code, Codex, OpenCode, Cursor, Gemini CLI, GitHub Copilot CLI, VS Code Copilot Chat, Aider, OpenClaw, Factory Droid, Trae, Hermes, Kiro ou Google Antigravity — il lit vos fichiers, construit un graphe de connaissances et vous révèle une structure que vous ne voyiez pas auparavant. Comprenez une base de code plus rapidement. Trouvez le « pourquoi » derrière les décisions architecturales.
+
+Entièrement multimodal. Déposez du code, des PDFs, du markdown, des captures d'écran, des diagrammes, des photos de tableau blanc, des images dans d'autres langues, ou des fichiers vidéo et audio — graphify extrait les concepts et les relations de tout cela et les connecte en un seul graphe. Les vidéos sont transcrites localement avec Whisper grâce à un prompt adapté au domaine. 25 langages de programmation supportés via tree-sitter AST (Python, JS, TS, Go, Rust, Java, C, C++, Ruby, C#, Kotlin, Scala, PHP, Swift, Lua, Zig, PowerShell, Elixir, Objective-C, Julia, Verilog, SystemVerilog, Vue, Svelte, Dart).
+
+> Andrej Karpathy maintient un dossier `/raw` où il dépose des articles, tweets, captures d'écran et notes. graphify est la réponse à ce problème — 71,5 fois moins de tokens par requête versus la lecture des fichiers bruts, persistant entre les sessions, honnête sur ce qui a été trouvé versus déduit.
+
+```
+/graphify . # fonctionne sur n'importe quel dossier — code, notes, articles, tout
+```
+
+```
+graphify-out/
+├── graph.html graphe interactif — ouvrir dans un navigateur, cliquer, rechercher, filtrer
+├── GRAPH_REPORT.md nœuds dieu, connexions surprenantes, questions suggérées
+├── graph.json graphe persistant — interrogeable des semaines plus tard sans relire
+└── cache/ cache SHA256 — les réexécutions ne traitent que les fichiers modifiés
+```
+
+Ajoutez un fichier `.graphifyignore` pour exclure des dossiers :
+
+```
+# .graphifyignore
+vendor/
+node_modules/
+dist/
+*.generated.py
+```
+
+Même syntaxe que `.gitignore`. Un seul `.graphifyignore` à la racine du dépôt suffit.
+
+## Comment ça fonctionne
+
+graphify s'exécute en trois passes. D'abord, un passage AST déterministe extrait la structure des fichiers de code (classes, fonctions, imports, graphes d'appel, docstrings, commentaires de justification) sans LLM. Ensuite, les fichiers vidéo et audio sont transcrits localement avec faster-whisper. Enfin, des sous-agents Claude s'exécutent en parallèle sur les docs, articles, images et transcriptions pour extraire concepts, relations et justifications de conception. Les résultats sont fusionnés dans un graphe NetworkX, regroupés avec la détection de communautés Leiden, et exportés en HTML interactif, JSON interrogeable et un rapport d'audit en langage naturel.
+
+**Le clustering est basé sur la topologie du graphe — pas d'embeddings.** Leiden trouve les communautés par densité d'arêtes. Les arêtes de similarité sémantique extraites par Claude (`semantically_similar_to`, marquées INFERRED) sont déjà dans le graphe. La structure du graphe est le signal de similarité — pas d'étape d'embedding séparée ni de base de données vectorielle nécessaire.
+
+Chaque relation est étiquetée `EXTRACTED` (trouvée directement dans la source), `INFERRED` (déduction raisonnable avec un score de confiance) ou `AMBIGUOUS` (marquée pour révision).
+
+## Installation
+
+**Prérequis :** Python 3.10+ et l'un de : [Claude Code](https://claude.ai/code), [Codex](https://openai.com/codex), [OpenCode](https://opencode.ai), [Cursor](https://cursor.com), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli), [VS Code Copilot Chat](https://code.visualstudio.com/docs/copilot/overview), [Aider](https://aider.chat), [OpenClaw](https://openclaw.ai), [Factory Droid](https://factory.ai), [Trae](https://trae.ai), [Kiro](https://kiro.dev), Hermes ou [Google Antigravity](https://antigravity.google)
+
+```bash
+# Recommandé — fonctionne sur Mac et Linux sans configuration du PATH
+uv tool install graphifyy && graphify install
+# ou avec pipx
+pipx install graphifyy && graphify install
+# ou pip simple
+pip install graphifyy && graphify install
+```
+
+> **Package officiel :** Le package PyPI s'appelle `graphifyy` (installer avec `pip install graphifyy`). Les autres packages nommés `graphify*` sur PyPI ne sont pas affiliés à ce projet. Le seul dépôt officiel est [safishamsi/graphify](https://github.com/safishamsi/graphify).
+
+### Support des plateformes
+
+| Plateforme | Commande d'installation |
+|------------|------------------------|
+| Claude Code (Linux/Mac) | `graphify install` |
+| Claude Code (Windows) | `graphify install` (détection automatique) ou `graphify install --platform windows` |
+| Codex | `graphify install --platform codex` |
+| OpenCode | `graphify install --platform opencode` |
+| GitHub Copilot CLI | `graphify install --platform copilot` |
+| VS Code Copilot Chat | `graphify vscode install` |
+| Aider | `graphify install --platform aider` |
+| OpenClaw | `graphify install --platform claw` |
+| Factory Droid | `graphify install --platform droid` |
+| Trae | `graphify install --platform trae` |
+| Trae CN | `graphify install --platform trae-cn` |
+| Gemini CLI | `graphify install --platform gemini` |
+| Hermes | `graphify install --platform hermes` |
+| Kiro IDE/CLI | `graphify kiro install` |
+| Cursor | `graphify cursor install` |
+| Google Antigravity | `graphify antigravity install` |
+
+Ensuite, ouvrez votre assistant de code IA et tapez :
+
+```
+/graphify .
+```
+
+Note : Codex utilise `$` au lieu de `/` pour les compétences, tapez donc `$graphify .`.
+
+### Toujours utiliser le graphe (recommandé)
+
+Après avoir construit un graphe, exécutez ceci une fois dans votre projet :
+
+| Plateforme | Commande |
+|------------|----------|
+| Claude Code | `graphify claude install` |
+| Codex | `graphify codex install` |
+| OpenCode | `graphify opencode install` |
+| Cursor | `graphify cursor install` |
+| Gemini CLI | `graphify gemini install` |
+| Kiro IDE/CLI | `graphify kiro install` |
+| Google Antigravity | `graphify antigravity install` |
+
+## Utilisation
+
+```
+/graphify # répertoire courant
+/graphify ./raw # dossier spécifique
+/graphify ./raw --mode deep # extraction d'arêtes INFERRED plus agressive
+/graphify ./raw --update # ne réextraire que les fichiers modifiés
+/graphify ./raw --directed # graphe dirigé
+/graphify ./raw --cluster-only # relancer le clustering sur le graphe existant
+/graphify ./raw --no-viz # pas d'HTML, juste rapport + JSON
+/graphify ./raw --obsidian # générer un vault Obsidian (opt-in)
+
+/graphify add https://arxiv.org/abs/1706.03762 # récupérer un article
+/graphify add # télécharger l'audio, transcrire, ajouter
+/graphify query "qu'est-ce qui connecte Attention à l'optimiseur ?"
+/graphify path "DigestAuth" "Response"
+/graphify explain "SwinTransformer"
+
+graphify hook install # installer les hooks Git
+graphify update ./src # réextraire les fichiers de code, sans LLM
+graphify watch ./src # mise à jour automatique du graphe
+```
+
+## Ce que vous obtenez
+
+**Nœuds dieu** — concepts avec le plus haut degré (tout passe par eux)
+
+**Connexions surprenantes** — classées par score composite. Les arêtes code-article sont mieux notées. Chaque résultat inclut un pourquoi en langage naturel.
+
+**Questions suggérées** — 4-5 questions que le graphe est particulièrement bien placé pour répondre
+
+**Le « pourquoi »** — docstrings, commentaires inline (`# NOTE:`, `# IMPORTANT:`, `# HACK:`, `# WHY:`), et justifications de conception extraits comme nœuds `rationale_for`.
+
+**Scores de confiance** — chaque arête INFERRED a un `confidence_score` (0,0-1,0).
+
+**Benchmark de tokens** — affiché automatiquement après chaque exécution. Sur un corpus mixte : **71,5 fois** moins de tokens par requête vs fichiers bruts.
+
+**Synchronisation automatique** (`--watch`) — met à jour le graphe automatiquement lors des modifications de code.
+
+**Hooks Git** (`graphify hook install`) — installe des hooks post-commit et post-checkout.
+
+## Confidentialité
+
+graphify envoie le contenu des fichiers à l'API du modèle de votre assistant IA pour l'extraction sémantique des docs, articles et images. Les fichiers de code sont traités localement via tree-sitter AST. Les fichiers vidéo et audio sont transcrits localement avec faster-whisper. Aucune télémétrie, aucun suivi d'utilisation.
+
+## Stack technique
+
+NetworkX + Leiden (graspologic) + tree-sitter + vis.js. Extraction sémantique via Claude, GPT-4 ou le modèle de votre plateforme. Transcription vidéo via faster-whisper + yt-dlp (optionnel).
+
+## Construit sur graphify — Penpax
+
+[**Penpax**](https://safishamsi.github.io/penpax.ai) est la couche enterprise au-dessus de graphify. Là où graphify transforme un dossier de fichiers en graphe de connaissances, Penpax applique le même graphe à toute votre vie professionnelle — en continu.
+
+**Essai gratuit bientôt disponible.** [Rejoindre la liste d'attente →](https://safishamsi.github.io/penpax.ai)
+
+## Historique des étoiles
+
+[](https://star-history.com/#safishamsi/graphify&Date)
diff --git a/README.hi-IN.md b/README.hi-IN.md
new file mode 100644
index 00000000..d23b6778
--- /dev/null
+++ b/README.hi-IN.md
@@ -0,0 +1,143 @@
+
+
+
+
+
+ English | 简体中文 | 日本語 | 한국어 | Deutsch | Français | Español | हिन्दी | Português | Русский | العربية
+
+
+
+
+
+
+
+
+
+
+**एक AI कोडिंग असिस्टेंट स्किल।** Claude Code, Codex, OpenCode, Cursor, Gemini CLI, GitHub Copilot CLI, VS Code Copilot Chat, Aider, OpenClaw, Factory Droid, Trae, Hermes, Kiro या Google Antigravity में `/graphify` टाइप करें — यह आपकी फ़ाइलें पढ़ता है, एक नॉलेज ग्राफ बनाता है, और आपको वह संरचना वापस देता है जो आप नहीं जानते थे कि मौजूद है। कोडबेस को तेज़ी से समझें। आर्किटेक्चरल निर्णयों के पीछे का "क्यों" खोजें।
+
+पूरी तरह मल्टीमोडल। कोड, PDFs, मार्कडाउन, स्क्रीनशॉट, डायग्राम, व्हाइटबोर्ड फोटो, अन्य भाषाओं में छवियां, या वीडियो और ऑडियो फ़ाइलें डालें — graphify इन सभी से अवधारणाएं और संबंध निकालता है और उन्हें एक ग्राफ में जोड़ता है। वीडियो को Whisper से स्थानीय रूप से ट्रांसक्राइब किया जाता है। 25 प्रोग्रामिंग भाषाएं tree-sitter AST के माध्यम से समर्थित हैं (Python, JS, TS, Go, Rust, Java, C, C++, Ruby, C#, Kotlin, Scala, PHP, Swift, Lua, Zig, PowerShell, Elixir, Objective-C, Julia, Verilog, SystemVerilog, Vue, Svelte, Dart)।
+
+> Andrej Karpathy एक `/raw` फोल्डर रखते हैं जहां वह papers, tweets, स्क्रीनशॉट और नोट्स डालते हैं। graphify उस समस्या का जवाब है — रॉ फ़ाइलें पढ़ने की तुलना में प्रति क्वेरी **71.5x** कम tokens, सत्रों में स्थायी, ईमानदार कि क्या पाया गया बनाम अनुमान लगाया गया।
+
+```
+/graphify . # किसी भी फोल्डर पर काम करता है — कोडबेस, नोट्स, papers, सब कुछ
+```
+
+```
+graphify-out/
+├── graph.html इंटरेक्टिव ग्राफ — किसी भी ब्राउज़र में खोलें, नोड्स क्लिक करें, खोजें
+├── GRAPH_REPORT.md गॉड नोड्स, आश्चर्यजनक कनेक्शन, सुझाए गए प्रश्न
+├── graph.json स्थायी ग्राफ — हफ्तों बाद भी क्वेरी करें
+└── cache/ SHA256 कैश — पुनः चलाने पर केवल बदली हुई फ़ाइलें प्रोसेस होती हैं
+```
+
+अनचाहे फोल्डर को बाहर करने के लिए `.graphifyignore` फ़ाइल जोड़ें:
+
+```
+# .graphifyignore
+vendor/
+node_modules/
+dist/
+*.generated.py
+```
+
+`.gitignore` जैसी ही सिंटेक्स।
+
+## यह कैसे काम करता है
+
+graphify तीन चरणों में चलता है। पहले, एक निर्धारक AST पास कोड फ़ाइलों से संरचना निकालता है — बिना किसी LLM के। दूसरे, वीडियो और ऑडियो फ़ाइलों को faster-whisper से स्थानीय रूप से ट्रांसक्राइब किया जाता है। तीसरे, Claude सबएजेंट दस्तावेज़ों, papers, छवियों और ट्रांसक्रिप्ट पर समानांतर में चलते हैं। परिणामों को NetworkX ग्राफ में मर्ज किया जाता है, Leiden कम्युनिटी डिटेक्शन से क्लस्टर किया जाता है, और इंटरेक्टिव HTML, क्वेरी करने योग्य JSON और एक ऑडिट रिपोर्ट के रूप में निर्यात किया जाता है।
+
+**क्लस्टरिंग ग्राफ-टोपोलॉजी आधारित है — कोई embeddings नहीं।** Claude द्वारा निकाले गए सिमेंटिक समानता किनारे पहले से ग्राफ में हैं, इसलिए वे कम्युनिटी डिटेक्शन को सीधे प्रभावित करते हैं।
+
+प्रत्येक संबंध `EXTRACTED` (स्रोत में सीधे पाया गया), `INFERRED` (उचित अनुमान, कॉन्फिडेंस स्कोर के साथ) या `AMBIGUOUS` (समीक्षा के लिए चिह्नित) के रूप में टैग किया जाता है।
+
+## इंस्टॉलेशन
+
+**आवश्यकताएं:** Python 3.10+ और निम्न में से एक: [Claude Code](https://claude.ai/code), [Codex](https://openai.com/codex), [OpenCode](https://opencode.ai), [Cursor](https://cursor.com), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli), [VS Code Copilot Chat](https://code.visualstudio.com/docs/copilot/overview), [Aider](https://aider.chat), [OpenClaw](https://openclaw.ai), [Factory Droid](https://factory.ai), [Trae](https://trae.ai), [Kiro](https://kiro.dev), Hermes या [Google Antigravity](https://antigravity.google)
+
+```bash
+# अनुशंसित — Mac और Linux पर PATH सेटअप के बिना काम करता है
+uv tool install graphifyy && graphify install
+# या pipx के साथ
+pipx install graphifyy && graphify install
+# या सामान्य pip
+pip install graphifyy && graphify install
+```
+
+> **आधिकारिक पैकेज:** PyPI पैकेज का नाम `graphifyy` है (`pip install graphifyy` से इंस्टॉल करें)। PyPI पर `graphify*` नाम वाले अन्य पैकेज इस प्रोजेक्ट से संबद्ध नहीं हैं। एकमात्र आधिकारिक रिपॉजिटरी [safishamsi/graphify](https://github.com/safishamsi/graphify) है।
+
+### प्लेटफॉर्म समर्थन
+
+| प्लेटफॉर्म | इंस्टॉल कमांड |
+|------------|---------------|
+| Claude Code (Linux/Mac) | `graphify install` |
+| Claude Code (Windows) | `graphify install` (स्वतः-पहचान) या `graphify install --platform windows` |
+| Codex | `graphify install --platform codex` |
+| OpenCode | `graphify install --platform opencode` |
+| GitHub Copilot CLI | `graphify install --platform copilot` |
+| VS Code Copilot Chat | `graphify vscode install` |
+| Aider | `graphify install --platform aider` |
+| OpenClaw | `graphify install --platform claw` |
+| Factory Droid | `graphify install --platform droid` |
+| Trae | `graphify install --platform trae` |
+| Gemini CLI | `graphify install --platform gemini` |
+| Hermes | `graphify install --platform hermes` |
+| Kiro IDE/CLI | `graphify kiro install` |
+| Cursor | `graphify cursor install` |
+| Google Antigravity | `graphify antigravity install` |
+
+फिर अपना AI कोडिंग असिस्टेंट खोलें और टाइप करें:
+
+```
+/graphify .
+```
+
+## उपयोग
+
+```
+/graphify # वर्तमान डायरेक्टरी
+/graphify ./raw # विशिष्ट फोल्डर
+/graphify ./raw --update # केवल बदली हुई फ़ाइलें फिर से निकालें
+/graphify ./raw --directed # निर्देशित ग्राफ
+/graphify ./raw --no-viz # केवल रिपोर्ट + JSON
+/graphify ./raw --obsidian # Obsidian vault बनाएं
+
+/graphify add https://arxiv.org/abs/1706.03762 # paper प्राप्त करें
+/graphify add # वीडियो ट्रांसक्राइब करें
+/graphify query "attention और optimizer को क्या जोड़ता है?"
+/graphify path "DigestAuth" "Response"
+/graphify explain "SwinTransformer"
+
+graphify hook install # Git hooks इंस्टॉल करें
+graphify update ./src # कोड फ़ाइलें पुनः निकालें, LLM की जरूरत नहीं
+graphify watch ./src # स्वचालित ग्राफ अपडेट
+```
+
+## आपको क्या मिलता है
+
+**गॉड नोड्स** — सबसे अधिक डिग्री वाली अवधारणाएं (जिनसे सब कुछ गुजरता है)
+
+**आश्चर्यजनक कनेक्शन** — कम्पोजिट स्कोर द्वारा रैंक किए गए। कोड-पेपर किनारे उच्च रैंक पाते हैं।
+
+**सुझाए गए प्रश्न** — 4-5 प्रश्न जिन्हें ग्राफ विशेष रूप से अच्छी तरह उत्तर दे सकता है
+
+**"क्यों"** — docstrings, inline comments, और design rationale को `rationale_for` नोड्स के रूप में निकाला जाता है।
+
+**कॉन्फिडेंस स्कोर** — प्रत्येक INFERRED किनारे का `confidence_score` (0.0-1.0) होता है।
+
+**टोकन बेंचमार्क** — प्रत्येक रन के बाद स्वचालित रूप से प्रिंट होता है। मिश्रित corpus पर: रॉ फ़ाइलों की तुलना में **71.5x** कम tokens।
+
+## गोपनीयता
+
+graphify दस्तावेज़ों, papers और छवियों के सिमेंटिक निष्कर्षण के लिए आपके AI असिस्टेंट की मॉडल API को फ़ाइल सामग्री भेजता है। कोड फ़ाइलें tree-sitter AST के माध्यम से स्थानीय रूप से प्रोसेस होती हैं। वीडियो और ऑडियो फ़ाइलें faster-whisper से स्थानीय रूप से ट्रांसक्राइब होती हैं। कोई टेलीमेट्री नहीं, कोई ट्रैकिंग नहीं।
+
+## graphify पर बनाया — Penpax
+
+[**Penpax**](https://safishamsi.github.io/penpax.ai) graphify के ऊपर एंटरप्राइज़ लेयर है। जहां graphify फ़ाइलों के एक फोल्डर को नॉलेज ग्राफ में बदलता है, Penpax वही ग्राफ आपके पूरे कार्य जीवन पर लागू करता है — निरंतर।
+
+**फ्री ट्रायल जल्द लॉन्च होगा।** [वेटलिस्ट में शामिल हों →](https://safishamsi.github.io/penpax.ai)
+
+## Star इतिहास
+
+[](https://star-history.com/#safishamsi/graphify&Date)
diff --git a/README.ja-JP.md b/README.ja-JP.md
index 69a32b12..660dfa94 100644
--- a/README.ja-JP.md
+++ b/README.ja-JP.md
@@ -1,6 +1,6 @@
# graphify
-[English](README.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja-JP.md) | [한국어](README.ko-KR.md)
+[English](README.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja-JP.md) | [한국어](README.ko-KR.md) | [Deutsch](README.de-DE.md) | [Français](README.fr-FR.md) | [Español](README.es-ES.md) | [हिन्दी](README.hi-IN.md) | [Português](README.pt-BR.md) | [Русский](README.ru-RU.md) | [العربية](README.ar-SA.md)
[](https://github.com/safishamsi/graphify/actions/workflows/ci.yml)
[](https://pypi.org/project/graphifyy/)
diff --git a/README.ko-KR.md b/README.ko-KR.md
index b712d30d..e78b21be 100644
--- a/README.ko-KR.md
+++ b/README.ko-KR.md
@@ -1,6 +1,6 @@
# graphify
-[English](README.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja-JP.md) | [한국어](README.ko-KR.md)
+[English](README.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja-JP.md) | [한국어](README.ko-KR.md) | [Deutsch](README.de-DE.md) | [Français](README.fr-FR.md) | [Español](README.es-ES.md) | [हिन्दी](README.hi-IN.md) | [Português](README.pt-BR.md) | [Русский](README.ru-RU.md) | [العربية](README.ar-SA.md)
[](https://github.com/safishamsi/graphify/actions/workflows/ci.yml)
[](https://pypi.org/project/graphifyy/)
diff --git a/README.md b/README.md
index 82c119a4..ede14b39 100644
--- a/README.md
+++ b/README.md
@@ -3,7 +3,7 @@
- English | 简体中文 | 日本語 | 한국어
+ English | 简体中文 | 日本語 | 한국어 | Deutsch | Français | Español | हिन्दी | Português | Русский | العربية
@@ -136,7 +136,7 @@ After building a graph, run this once in your project:
**Kiro IDE/CLI** writes the skill to `.kiro/skills/graphify/SKILL.md` (invoked via `/graphify`) and a steering file to `.kiro/steering/graphify.md` with `inclusion: always` — Kiro injects this into every conversation automatically, no hook needed.
-**Google Antigravity** writes `.agent/rules/graphify.md` (always-on rules) and `.agent/workflows/graphify.md` (registers `/graphify` as a slash command). No hook equivalent exists in Antigravity — rules are the always-on mechanism.
+**Google Antigravity** writes `.agents/rules/graphify.md` (always-on rules) and `.agents/workflows/graphify.md` (registers `/graphify` as a slash command). No hook equivalent exists in Antigravity — rules are the always-on mechanism.
**GitHub Copilot CLI** copies the skill to `~/.copilot/skills/graphify/SKILL.md`. Run `graphify copilot install` to set it up.
@@ -294,7 +294,7 @@ graphify hermes install # AGENTS.md + ~/.hermes/skills/ (Hermes)
graphify hermes uninstall
graphify kiro install # .kiro/skills/ + .kiro/steering/graphify.md (Kiro IDE/CLI)
graphify kiro uninstall
-graphify antigravity install # .agent/rules + .agent/workflows (Google Antigravity)
+graphify antigravity install # .agents/rules + .agents/workflows (Google Antigravity)
graphify antigravity uninstall
# query and navigate the graph directly from the terminal (no AI assistant needed)
diff --git a/README.pt-BR.md b/README.pt-BR.md
new file mode 100644
index 00000000..b7d63f97
--- /dev/null
+++ b/README.pt-BR.md
@@ -0,0 +1,170 @@
+
+
+
+
+
+ English | 简体中文 | 日本語 | 한국어 | Deutsch | Français | Español | हिन्दी | Português | Русский | العربية
+
+
+
+
+
+
+
+
+
+
+**Uma habilidade para assistentes de código IA.** Digite `/graphify` no Claude Code, Codex, OpenCode, Cursor, Gemini CLI, GitHub Copilot CLI, VS Code Copilot Chat, Aider, OpenClaw, Factory Droid, Trae, Hermes, Kiro ou Google Antigravity — ele lê seus arquivos, constrói um grafo de conhecimento e devolve a você estrutura que você não sabia que existia. Entenda uma base de código mais rapidamente. Encontre o "porquê" por trás das decisões arquiteturais.
+
+Totalmente multimodal. Adicione código, PDFs, markdown, capturas de tela, diagramas, fotos de quadros brancos, imagens em outros idiomas, ou arquivos de vídeo e áudio — graphify extrai conceitos e relações de tudo isso e os conecta em um único grafo. Vídeos são transcritos localmente com Whisper usando um prompt adaptado ao domínio derivado do seu corpus. 25 linguagens de programação suportadas via tree-sitter AST (Python, JS, TS, Go, Rust, Java, C, C++, Ruby, C#, Kotlin, Scala, PHP, Swift, Lua, Zig, PowerShell, Elixir, Objective-C, Julia, Verilog, SystemVerilog, Vue, Svelte, Dart).
+
+> Andrej Karpathy mantém uma pasta `/raw` onde deposita papers, tweets, capturas de tela e notas. graphify é a resposta para esse problema — 71,5x menos tokens por consulta versus ler os arquivos brutos, persistente entre sessões, honesto sobre o que foi encontrado versus inferido.
+
+```
+/graphify . # funciona em qualquer pasta — seu código, notas, papers, tudo
+```
+
+```
+graphify-out/
+├── graph.html grafo interativo — abrir em qualquer navegador, clicar em nós, pesquisar
+├── GRAPH_REPORT.md nós deus, conexões surpreendentes, perguntas sugeridas
+├── graph.json grafo persistente — consultar semanas depois sem reler
+└── cache/ cache SHA256 — re-execuções processam apenas arquivos modificados
+```
+
+Adicione um arquivo `.graphifyignore` para excluir pastas:
+
+```
+# .graphifyignore
+vendor/
+node_modules/
+dist/
+*.generated.py
+```
+
+Mesma sintaxe do `.gitignore`.
+
+## Como funciona
+
+graphify executa em três passes. Primeiro, uma passagem AST determinística extrai estrutura de arquivos de código (classes, funções, importações, grafos de chamadas, docstrings, comentários de justificativa) sem LLM. Segundo, arquivos de vídeo e áudio são transcritos localmente com faster-whisper. Terceiro, subagentes Claude executam em paralelo sobre documentos, papers, imagens e transcrições para extrair conceitos, relações e justificativas de design. Os resultados são mesclados em um grafo NetworkX, agrupados com detecção de comunidades Leiden, e exportados como HTML interativo, JSON consultável e um relatório de auditoria em linguagem natural.
+
+**O clustering é baseado em topologia de grafo — sem embeddings.** Leiden encontra comunidades por densidade de arestas. As arestas de similaridade semântica que Claude extrai (`semantically_similar_to`, marcadas INFERRED) já estão no grafo. A estrutura do grafo é o sinal de similaridade — nenhum passo de embedding separado ou banco de dados vetorial é necessário.
+
+Cada relação é marcada como `EXTRACTED` (encontrada diretamente na fonte), `INFERRED` (inferência razoável com pontuação de confiança) ou `AMBIGUOUS` (marcada para revisão).
+
+## Instalação
+
+**Requisitos:** Python 3.10+ e um de: [Claude Code](https://claude.ai/code), [Codex](https://openai.com/codex), [OpenCode](https://opencode.ai), [Cursor](https://cursor.com), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli), [VS Code Copilot Chat](https://code.visualstudio.com/docs/copilot/overview), [Aider](https://aider.chat), [OpenClaw](https://openclaw.ai), [Factory Droid](https://factory.ai), [Trae](https://trae.ai), [Kiro](https://kiro.dev), Hermes ou [Google Antigravity](https://antigravity.google)
+
+```bash
+# Recomendado — funciona no Mac e Linux sem configurar o PATH
+uv tool install graphifyy && graphify install
+# ou com pipx
+pipx install graphifyy && graphify install
+# ou pip simples
+pip install graphifyy && graphify install
+```
+
+> **Pacote oficial:** O pacote PyPI chama-se `graphifyy` (instalar com `pip install graphifyy`). Outros pacotes chamados `graphify*` no PyPI não são afiliados a este projeto. O único repositório oficial é [safishamsi/graphify](https://github.com/safishamsi/graphify).
+
+### Suporte a plataformas
+
+| Plataforma | Comando de instalação |
+|------------|-----------------------|
+| Claude Code (Linux/Mac) | `graphify install` |
+| Claude Code (Windows) | `graphify install` (detecção automática) ou `graphify install --platform windows` |
+| Codex | `graphify install --platform codex` |
+| OpenCode | `graphify install --platform opencode` |
+| GitHub Copilot CLI | `graphify install --platform copilot` |
+| VS Code Copilot Chat | `graphify vscode install` |
+| Aider | `graphify install --platform aider` |
+| OpenClaw | `graphify install --platform claw` |
+| Factory Droid | `graphify install --platform droid` |
+| Trae | `graphify install --platform trae` |
+| Trae CN | `graphify install --platform trae-cn` |
+| Gemini CLI | `graphify install --platform gemini` |
+| Hermes | `graphify install --platform hermes` |
+| Kiro IDE/CLI | `graphify kiro install` |
+| Cursor | `graphify cursor install` |
+| Google Antigravity | `graphify antigravity install` |
+
+Depois abra seu assistente de código IA e digite:
+
+```
+/graphify .
+```
+
+Nota: Codex usa `$` em vez de `/` para habilidades, então digite `$graphify .`.
+
+### Fazer o assistente sempre usar o grafo (recomendado)
+
+Após construir um grafo, execute isso uma vez no seu projeto:
+
+| Plataforma | Comando |
+|------------|---------|
+| Claude Code | `graphify claude install` |
+| Codex | `graphify codex install` |
+| OpenCode | `graphify opencode install` |
+| Cursor | `graphify cursor install` |
+| Gemini CLI | `graphify gemini install` |
+| Kiro IDE/CLI | `graphify kiro install` |
+| Google Antigravity | `graphify antigravity install` |
+
+## Uso
+
+```
+/graphify # diretório atual
+/graphify ./raw # pasta específica
+/graphify ./raw --mode deep # extração de arestas INFERRED mais agressiva
+/graphify ./raw --update # re-extrair apenas arquivos modificados
+/graphify ./raw --directed # grafo dirigido
+/graphify ./raw --cluster-only # re-executar clustering no grafo existente
+/graphify ./raw --no-viz # sem HTML, apenas relatório + JSON
+/graphify ./raw --obsidian # gerar vault do Obsidian (opt-in)
+
+/graphify add https://arxiv.org/abs/1706.03762 # buscar um paper
+/graphify add # baixar áudio, transcrever, adicionar
+/graphify query "o que conecta Attention ao otimizador?"
+/graphify path "DigestAuth" "Response"
+/graphify explain "SwinTransformer"
+
+graphify hook install # instalar hooks do Git
+graphify update ./src # re-extrair arquivos de código, sem LLM
+graphify watch ./src # atualização automática do grafo
+```
+
+## O que você obtém
+
+**Nós deus** — conceitos com maior grau (por onde tudo passa)
+
+**Conexões surpreendentes** — classificadas por pontuação composta. Arestas código-paper pontuam mais alto. Cada resultado inclui um porquê em linguagem natural.
+
+**Perguntas sugeridas** — 4-5 perguntas que o grafo está em posição única de responder
+
+**O "porquê"** — docstrings, comentários inline (`# NOTE:`, `# IMPORTANT:`, `# HACK:`, `# WHY:`), e justificativas de design extraídas como nós `rationale_for`.
+
+**Pontuações de confiança** — cada aresta INFERRED tem um `confidence_score` (0,0-1,0).
+
+**Benchmark de tokens** — impresso automaticamente após cada execução. Em um corpus misto: **71,5x** menos tokens por consulta vs arquivos brutos.
+
+**Sincronização automática** (`--watch`) — atualiza o grafo automaticamente quando o código muda.
+
+**Hooks do Git** (`graphify hook install`) — instala hooks post-commit e post-checkout.
+
+## Privacidade
+
+graphify envia conteúdo de arquivos para a API do modelo do seu assistente IA para extração semântica de documentos, papers e imagens. Arquivos de código são processados localmente via tree-sitter AST. Arquivos de vídeo e áudio são transcritos localmente com faster-whisper. Sem telemetria, sem rastreamento de uso.
+
+## Stack técnico
+
+NetworkX + Leiden (graspologic) + tree-sitter + vis.js. Extração semântica via Claude, GPT-4 ou o modelo da sua plataforma. Transcrição de vídeo via faster-whisper + yt-dlp (opcional).
+
+## Construído sobre graphify — Penpax
+
+[**Penpax**](https://safishamsi.github.io/penpax.ai) é a camada enterprise sobre o graphify. Onde o graphify transforma uma pasta de arquivos em um grafo de conhecimento, o Penpax aplica o mesmo grafo a toda a sua vida profissional — continuamente.
+
+**Teste gratuito em breve.** [Entrar na lista de espera →](https://safishamsi.github.io/penpax.ai)
+
+## Histórico de estrelas
+
+[](https://star-history.com/#safishamsi/graphify&Date)
diff --git a/README.ru-RU.md b/README.ru-RU.md
new file mode 100644
index 00000000..e5c94955
--- /dev/null
+++ b/README.ru-RU.md
@@ -0,0 +1,170 @@
+
+
+
+
+
+ English | 简体中文 | 日本語 | 한국어 | Deutsch | Français | Español | हिन्दी | Português | Русский | العربية
+
+
+
+
+
+
+
+
+
+
+**Навык для AI-ассистента по написанию кода.** Введите `/graphify` в Claude Code, Codex, OpenCode, Cursor, Gemini CLI, GitHub Copilot CLI, VS Code Copilot Chat, Aider, OpenClaw, Factory Droid, Trae, Hermes, Kiro или Google Antigravity — он прочитает ваши файлы, построит граф знаний и вернёт вам структуру, о существовании которой вы не подозревали. Понимайте кодовую базу быстрее. Находите «почему» за архитектурными решениями.
+
+Полностью мультимодальный. Добавляйте код, PDF, markdown, скриншоты, диаграммы, фотографии досок, изображения на других языках, видео и аудиофайлы — graphify извлекает концепции и связи из всего этого и объединяет их в один граф. Видео транскрибируются локально с Whisper, используя доменный промпт из вашего корпуса. Поддерживается 25 языков программирования через tree-sitter AST (Python, JS, TS, Go, Rust, Java, C, C++, Ruby, C#, Kotlin, Scala, PHP, Swift, Lua, Zig, PowerShell, Elixir, Objective-C, Julia, Verilog, SystemVerilog, Vue, Svelte, Dart).
+
+> Андрей Карпати ведёт папку `/raw`, куда складывает статьи, твиты, скриншоты и заметки. graphify — ответ на эту проблему: в **71,5 раза** меньше токенов на запрос по сравнению с чтением сырых файлов, сохранение между сессиями, честность относительно того, что найдено, а что выведено.
+
+```
+/graphify . # работает с любой папкой — код, заметки, статьи, всё что угодно
+```
+
+```
+graphify-out/
+├── graph.html интерактивный граф — открыть в браузере, кликать по узлам, искать, фильтровать
+├── GRAPH_REPORT.md бог-узлы, неожиданные связи, предлагаемые вопросы
+├── graph.json постоянный граф — запрашивать через недели без повторного чтения
+└── cache/ SHA256-кэш — повторные запуски обрабатывают только изменённые файлы
+```
+
+Добавьте файл `.graphifyignore` для исключения папок:
+
+```
+# .graphifyignore
+vendor/
+node_modules/
+dist/
+*.generated.py
+```
+
+Синтаксис аналогичен `.gitignore`.
+
+## Как это работает
+
+graphify работает в три прохода. Сначала детерминированный AST-проход извлекает структуру из файлов кода (классы, функции, импорты, графы вызовов, docstrings, комментарии с обоснованием) — без LLM. Затем видео и аудиофайлы транскрибируются локально с faster-whisper. Наконец, Claude-субагенты запускаются параллельно над документами, статьями, изображениями и транскриптами для извлечения концепций, связей и обоснований дизайна. Результаты объединяются в граф NetworkX, кластеризуются с помощью Leiden-детекции сообществ и экспортируются как интерактивный HTML, запрашиваемый JSON и аудит-отчёт на естественном языке.
+
+**Кластеризация основана на топологии графа — без эмбеддингов.** Leiden находит сообщества по плотности рёбер. Рёбра семантического сходства, извлечённые Claude (`semantically_similar_to`, помечены как INFERRED), уже в графе. Структура графа — это сигнал сходства. Отдельный шаг с эмбеддингами или векторная база данных не нужны.
+
+Каждая связь помечена как `EXTRACTED` (найдена непосредственно в источнике), `INFERRED` (обоснованный вывод с оценкой уверенности) или `AMBIGUOUS` (помечена для проверки).
+
+## Установка
+
+**Требования:** Python 3.10+ и одно из: [Claude Code](https://claude.ai/code), [Codex](https://openai.com/codex), [OpenCode](https://opencode.ai), [Cursor](https://cursor.com), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli), [VS Code Copilot Chat](https://code.visualstudio.com/docs/copilot/overview), [Aider](https://aider.chat), [OpenClaw](https://openclaw.ai), [Factory Droid](https://factory.ai), [Trae](https://trae.ai), [Kiro](https://kiro.dev), Hermes или [Google Antigravity](https://antigravity.google)
+
+```bash
+# Рекомендуется — работает на Mac и Linux без настройки PATH
+uv tool install graphifyy && graphify install
+# или с pipx
+pipx install graphifyy && graphify install
+# или обычный pip
+pip install graphifyy && graphify install
+```
+
+> **Официальный пакет:** Пакет PyPI называется `graphifyy` (установить через `pip install graphifyy`). Другие пакеты с именем `graphify*` на PyPI не связаны с этим проектом. Единственный официальный репозиторий — [safishamsi/graphify](https://github.com/safishamsi/graphify).
+
+### Поддержка платформ
+
+| Платформа | Команда установки |
+|-----------|-------------------|
+| Claude Code (Linux/Mac) | `graphify install` |
+| Claude Code (Windows) | `graphify install` (авто-определение) или `graphify install --platform windows` |
+| Codex | `graphify install --platform codex` |
+| OpenCode | `graphify install --platform opencode` |
+| GitHub Copilot CLI | `graphify install --platform copilot` |
+| VS Code Copilot Chat | `graphify vscode install` |
+| Aider | `graphify install --platform aider` |
+| OpenClaw | `graphify install --platform claw` |
+| Factory Droid | `graphify install --platform droid` |
+| Trae | `graphify install --platform trae` |
+| Trae CN | `graphify install --platform trae-cn` |
+| Gemini CLI | `graphify install --platform gemini` |
+| Hermes | `graphify install --platform hermes` |
+| Kiro IDE/CLI | `graphify kiro install` |
+| Cursor | `graphify cursor install` |
+| Google Antigravity | `graphify antigravity install` |
+
+Затем откройте AI-ассистент и введите:
+
+```
+/graphify .
+```
+
+Примечание: Codex использует `$` вместо `/` для навыков, поэтому вводите `$graphify .`.
+
+### Заставить ассистента всегда использовать граф (рекомендуется)
+
+После построения графа выполните это один раз в вашем проекте:
+
+| Платформа | Команда |
+|-----------|---------|
+| Claude Code | `graphify claude install` |
+| Codex | `graphify codex install` |
+| OpenCode | `graphify opencode install` |
+| Cursor | `graphify cursor install` |
+| Gemini CLI | `graphify gemini install` |
+| Kiro IDE/CLI | `graphify kiro install` |
+| Google Antigravity | `graphify antigravity install` |
+
+## Использование
+
+```
+/graphify # текущая директория
+/graphify ./raw # конкретная папка
+/graphify ./raw --mode deep # более агрессивное извлечение INFERRED-рёбер
+/graphify ./raw --update # повторно извлечь только изменённые файлы
+/graphify ./raw --directed # направленный граф
+/graphify ./raw --cluster-only # перезапустить кластеризацию на существующем графе
+/graphify ./raw --no-viz # без HTML, только отчёт + JSON
+/graphify ./raw --obsidian # создать Obsidian vault (opt-in)
+
+/graphify add https://arxiv.org/abs/1706.03762 # получить статью
+/graphify add # скачать аудио, транскрибировать, добавить
+/graphify query "что связывает Attention с оптимизатором?"
+/graphify path "DigestAuth" "Response"
+/graphify explain "SwinTransformer"
+
+graphify hook install # установить Git-хуки
+graphify update ./src # повторно извлечь файлы кода, без LLM
+graphify watch ./src # автоматическое обновление графа
+```
+
+## Что вы получаете
+
+**Бог-узлы** — концепции с наибольшей степенью (через которые проходит всё)
+
+**Неожиданные связи** — отсортированы по составному баллу. Рёбра код-статья получают более высокий рейтинг. Каждый результат содержит объяснение «почему» на естественном языке.
+
+**Предлагаемые вопросы** — 4-5 вопросов, на которые граф уникально способен ответить
+
+**«Почему»** — docstrings, встроенные комментарии (`# NOTE:`, `# IMPORTANT:`, `# HACK:`, `# WHY:`), и обоснования дизайна из документов извлекаются как узлы `rationale_for`.
+
+**Оценки уверенности** — каждое INFERRED-ребро имеет `confidence_score` (0,0-1,0).
+
+**Бенчмарк токенов** — выводится автоматически после каждого запуска. На смешанном корпусе: **71,5-кратное** сокращение токенов на запрос vs сырые файлы.
+
+**Авто-синхронизация** (`--watch`) — обновляет граф автоматически при изменении кода.
+
+**Git-хуки** (`graphify hook install`) — устанавливает post-commit и post-checkout хуки.
+
+## Конфиденциальность
+
+graphify отправляет содержимое файлов в API модели вашего AI-ассистента для семантического извлечения из документов, статей и изображений. Файлы кода обрабатываются локально через tree-sitter AST. Видео и аудиофайлы транскрибируются локально с faster-whisper. Никакой телеметрии, никакого отслеживания использования.
+
+## Технологический стек
+
+NetworkX + Leiden (graspologic) + tree-sitter + vis.js. Семантическое извлечение через Claude, GPT-4 или модель вашей платформы. Транскрипция видео через faster-whisper + yt-dlp (опционально).
+
+## Построено на graphify — Penpax
+
+[**Penpax**](https://safishamsi.github.io/penpax.ai) — корпоративный слой поверх graphify. Там, где graphify превращает папку с файлами в граф знаний, Penpax применяет тот же граф ко всей вашей рабочей жизни — непрерывно.
+
+**Бесплатный пробный период скоро.** [Вступить в список ожидания →](https://safishamsi.github.io/penpax.ai)
+
+## История звёзд
+
+[](https://star-history.com/#safishamsi/graphify&Date)
diff --git a/README.zh-CN.md b/README.zh-CN.md
index aecaa51a..caa9811e 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -1,6 +1,6 @@
# graphify
-[English](README.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja-JP.md) | [한국어](README.ko-KR.md)
+[English](README.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja-JP.md) | [한국어](README.ko-KR.md) | [Deutsch](README.de-DE.md) | [Français](README.fr-FR.md) | [Español](README.es-ES.md) | [हिन्दी](README.hi-IN.md) | [Português](README.pt-BR.md) | [Русский](README.ru-RU.md) | [العربية](README.ar-SA.md)
[](https://github.com/safishamsi/graphify/actions/workflows/ci.yml)
[](https://pypi.org/project/graphifyy/)