PyGraphIt

Turn any Python repository into a queryable knowledge graph using static analysis via Python's built-in ast. It instantly finds functions, classes, and variables, maps how they interact, and saves the graph and source code to a portable SQLite database.

Installation

Install directly from the source code:

pip install -e .

Quick Start

1. Build the Graph

Map an entire Python project to a local .db file:

pygraphit-index /path/to/project --db my_project.db

2. Query the Graph

Retrieve code chunks and trace dependencies for any node (e.g. login), traversing outwards by --depth:

pygraphit-query login --depth 2 --db my_project.db

3. Visualize

Generate an interactive HTML graph of the architecture:

pygraphit-visualize --db my_project.db --out graph_view.html

(Open graph_view.html in any web browser!)