Graphify
Open-Source Knowledge Graph Skill

Graphify — Knowledge Graphs
for AI Coding Assistants

Graphify is an open-source skill that helps AI coding assistants understand multi-modal codebases by building a queryable knowledge graph from code, docs, papers and diagrams.

Click to Use Graphify MCP Free

What is Graphify?

Graphify is a multi-modal knowledge graph builder created for AI coding assistants such as Claude Code, OpenAI Codex and OpenCode. By combining Tree-sitter static analysis with LLM-driven semantic extraction, Graphify turns an entire repository — including source code, documentation, research papers and diagrams — into an interactive graph that explains both what the code does and why it was designed that way. The upstream open-source software is released under the permissive MIT license and built on widely-trusted libraries including NetworkX and Tree-sitter. This Graphify website is an independently operated, fan-made project. It is not affiliated with or endorsed by Graphify Labs.

3.7k+GitHub Stars
MITLicense
71.5×Token Reduction
Python 3.10+Runtime

Core Capabilities

Graphify unifies static analysis, semantic extraction and graph clustering into a single skill that any AI coding assistant can invoke.

Multi-Modal Extraction

Parses code (.py, .js, .go, .java, …), Markdown, PDFs and images. Tree-sitter extracts ASTs, call graphs and docstrings; LLMs extract concepts from prose; vision models read diagrams.

Knowledge Graph Build

Merges all extracted nodes and edges into a NetworkX graph and applies the Leiden algorithm for semantic community detection — no vector embeddings required.

God Nodes & Surprises

Identifies the highest-degree "god nodes" at the heart of the system and flags unexpected cross-file or cross-domain connections worth investigating.

Interactive Outputs

Exports an interactive graph.html, a queryable graph.json, and a human-readable GRAPH_REPORT.md audit report.

Assistant Integration

Ships with /graphify, /graphify query, /graphify path and /graphify explain commands for Claude Code, Codex, OpenCode and more.

Secure by Design

Strict input validation: only http/https URLs, size and timeout limits, path containment, HTML-escaped node labels — defending against SSRF, injection and XSS.

Architecture & Pipeline

Graphify is a multi-stage pipeline. Each stage is an isolated module so contributors can extend any step independently.

detect — collect files extract — AST + LLM nodes/edges build — NetworkX graph cluster — Leiden communities analyze — god nodes & surprises report — GRAPH_REPORT.md export — HTML / JSON / Obsidian

Supporting modules include ingest.py for URL fetching, cache.py for semantic caching, security.py for input validation, watch.py for live updates and serve.py for MCP-protocol service.

Install & Run

Install Graphify AI from the repository with Python 3.12 and uv. The package is private-context-mcp; the CLI command is private-context.

# Requires Python 3.12 and uv; run from the Graphify AI repository root
uv sync --extra dev --extra cloud --no-editable \
  --reinstall-package private-context-mcp

# Verify the local installation
uv run --no-sync private-context doctor

# Start the local stdio MCP server
uv run --no-sync private-context serve --transport stdio

The commands use Graphify AI’s locked dependencies and local runtime. Use the hosted console at app.graaph.org when you do not need a local installation.

Worked Examples

The repository ships with reproducible corpora demonstrating Graphify on both small libraries and large mixed code-and-paper collections.

httpx (small)

6 Python files modeling an HTTP transport layer. Result: 144 nodes, 330 edges, 6 communities. God nodes: Client, AsyncClient, Response, Request. Surprise edge: DigestAuth → Response.

Karpathy mixed corpus

3 GPT framework repos + 5 attention papers + 4 diagrams (~52 files, ~92k words). Result: 285 nodes, 340 edges, 53 communities. Average query cost ~1.7k tokens vs ~123k naive — a 71.5× reduction.

Comparison

How Graphify relates to adjacent open-source projects in the code-intelligence space.

ProjectFocusStrengthLimitation vs Graphify
SourcegraphCross-repo code searchEnterprise-grade navigationNot a knowledge graph; limited design semantics
Code2VecFunction-level embeddingsVector retrieval & classificationNo graph structure, no multi-modal input
Neo4jGeneral graph databasePowerful Cypher queriesDoes not generate graphs from code itself

Security, Licensing & Trust

Graphify is released under the MIT License. Its core dependencies — NetworkX (BSD) and Tree-sitter (MIT) — are all permissive open-source licenses with no conflicts. The project performs no telemetry. The only outbound network call is the semantic-extraction step, which uses your own configured AI model API key; only semantic descriptions of documents are transmitted, never raw source code. URLs are restricted to http/https, downloads are size- and time-bounded, output paths are containment-checked, and node labels are HTML-escaped to prevent SSRF, Cypher injection and XSS.

Frequently Asked Questions

Does Graphify send my code to a third-party model?

No. Graphify only sends semantic descriptions of documents and diagrams to the AI model you have already configured in your assistant — never raw source files.

Which AI coding assistants are supported?

Claude Code, OpenAI Codex and OpenCode are supported out of the box via dedicated skill-*.md manifests. Any assistant that can call shell commands can invoke graphify.

How large a codebase can Graphify handle?

Tree-sitter parsing and NetworkX construction scale linearly with code size. On a ~500k-word corpus, BFS subgraph queries stay around ~2k tokens versus ~670k naive — preserving compression at scale.

Is Graphify free for commercial use?

Yes. Graphify is MIT-licensed and free for both personal and commercial use.