Skip to content

Latest commit

 

History

History
180 lines (131 loc) · 12.7 KB

File metadata and controls

180 lines (131 loc) · 12.7 KB

Graphify

🇺🇸 English | 🇨🇳 简体中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇩🇪 Deutsch | 🇫🇷 Français | 🇪🇸 Español | 🇮🇳 हिन्दी | 🇧🇷 Português | 🇷🇺 Русский | 🇸🇦 العربية | 🇮🇹 Italiano | 🇵🇱 Polski | 🇳🇱 Nederlands | 🇹🇷 Türkçe | 🇺🇦 Українська | 🇻🇳 Tiếng Việt | 🇮🇩 Bahasa Indonesia | 🇸🇪 Svenska | 🇬🇷 Ελληνικά | 🇷🇴 Română | 🇨🇿 Čeština | 🇫🇮 Suomi | 🇩🇰 Dansk | 🇳🇴 Norsk | 🇭🇺 Magyar | 🇹🇭 ภาษาไทย | 🇹🇼 繁體中文

CI PyPI Downloads Sponsor LinkedIn

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, Codex, OpenCode, Cursor, Gemini CLI, GitHub Copilot CLI, VS Code Copilot Chat, Aider, OpenClaw, Factory Droid, Trae, Kiro, Hermes oder Google Antigravity

# 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. 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 <video-url>                         # 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 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 →

Star-Verlauf

Star History Chart