A simple but powerful tool to visualize dependencies in your codebase.
This tool scans your project and generates an interactive graph showing how files depend on each other across multiple programming languages.
⚠ Note: This is a beta version! It might:
- Miss some dependencies in complex projects
- Be slow on very large codebases
- Have occasional bugs
| Language | File Extensions |
|---|---|
| Go (Golang) | .go, _test.go |
| Java | .java |
| Python | .py |
| JavaScript | .js, .jsx, .mjs |
| TypeScript | .ts, .tsx |
| C | .c, .h |
| C++ | .cpp, .hpp, etc. |
| Rust | .rs |
| Ruby | .rb |
| PHP | .php |
| C# | .cs |
| Kotlin | .kt |
| Swift | .swift |
-
Install Python 3.7+ (if not already installed)
-
Install dependencies:
pip install pyvis tqdm
Or using requirements.txt (First complete step 3):
pip install -r requirements.txt
-
Download the script (Or .zip):
curl -O https://raw.githubusercontent.com/nazarhktwitch/dependencies-visualizer/main/main.py
Or with Git (You must have Git installed in your system):
git clone https://github.com/nazarhktwitch/dependencies-visualizer/
(For Git method (Windows):
cd dependencies-visualizer
python visualizer.py /path/to/your/project| Flag | Description |
|---|---|
-o output.html |
Custom output filename |
--exclude dir1 dir2 |
Skip specific directories |
Example:
python main.py ~/my_project -o deps.html --exclude node_modules build- Scans your project for imports/includes in supported languages.
- Builds a graph showing file relationships.
- Generates an interactive HTML visualization (open in browser).
- Large projects (>10k files) may take time to process.
- External dependencies (like npm packages) are shown as-is.
- Some edge cases might be missed (dynamic imports, macros, etc.).
✅ Exclude build folders (--exclude node_modules build)
✅ Run in a smaller subdirectory first for testing
✅ Check the console output for warnings
MIT License - Free to use and modify.