A sleek, lightweight visualization tool that transforms your Python codebase into an interactive network graph, revealing connections between files, classes, methods, and functions. Perfect for identifying "floating nodes" – forgotten or unrealized components in your projects.
- Holistic Code Analysis: See your entire codebase as an interconnected network
- Relationship Discovery: Visualize how components connect and interact
- Floating Node Detection: Quickly identify unused or disconnected code
- Responsive Design: Works seamlessly on desktop and mobile devices
- Lightweight: No heavy dependencies or frameworks
-
Clone the repository
git clone https://github.com/Maloskins/python-codebase-visualizer.git cd python-codebase-visualizer -
Start a local server
# Using Python's built-in HTTP server python -m http.server 8000 -
Open in your browser
http://localhost:8000 -
Analyze your codebase
- Click "Choose Directory" to select a directory of Python files
- Or click "Load Sample Code" to see the visualizer in action with example files
- Explore the generated graph, zoom in/out, and click on nodes to see detailed information
Developed by me to assist in identifying forgotten components of a model framework I was working on, this tool emerged from my research in Geometric Neural Networks, wondering why graph networks were not used diagnostically or as ubiquitously as I would have anticipated. I needed a way to quality-check code from a more holistic perspective, identifying seeing relationships that aren't immediately obvious when looking at individual files.
I am aware similar tools exist but they are often convoluted and dont have magenta highlights or cool fish noises.
- Front-end: HTML5, CSS3, and vanilla JavaScript (ES6+)
- Visualization: D3.js for the force-directed graph
- Parser: Custom JavaScript parser for Python code analysis
- Responsive Design: Works on devices of all sizes
- No Backend Required: Runs entirely in the browser
Contributions, issues, and feature requests are welcome! Feel free to check the issues page or contact me directly.
If you find this tool useful, consider buying me a coffee:
I will be working on expanding the utility for different languages and allow it to automatically clone and scan repos. I have been adding functionality and will be hosting this on CF soon.
This project is MIT licensed.
Created with AI and Stupidity by Matthew Haskins