🔍 CodeLens: Python Codebase Visualizer

Transform any Python codebase into an interactive visual map within seconds. Powered by AST, NetworkX, and PyVis.

✨ Overview

CodeLens helps you understand complex Python projects at a glance. Simply upload your codebase, and watch as it transforms into an interactive visualization of classes, functions, and their relationships.

🚀 Key Features

• Instant Analysis: Upload any Python project as ZIP and get immediate insights
• Deep Understanding: Automatically maps all classes and function relationships
• Interactive Exploration: Navigate through your codebase visually
• Zero Configuration: No setup required - just upload and explore

🎮 Live Demo

Experience CodeLens in action: Try the Live Demo

🎥 Demo

Click here to watch the demo video

🛠️ Technology Stack

• Core Engine: Python 3.9+
• Code Analysis: Abstract Syntax Trees (AST)
• Graph Processing: NetworkX
• Visualization: PyVis
• User Interface: Streamlit

🔄 Architecture

graph LR
    A[Code Upload] --> B[AST Parser]
    B --> C[Structure Analyzer]
    C --> D[Graph Generator]
    D --> E[Interactive Visualization]

Loading

💻 Quick Start

1. Clone & Navigate

git clone https://github.com/yourusername/codelens.git
cd codelens

2. Setup Environment

python -m venv venv
# Windows
venv\Scripts\activate
# Unix/MacOS
source venv/bin/activate
pip install -r requirements.txt

3. Launch Application

streamlit run app.py

📁 Project Structure

codelens/
├── app.py              # Main Streamlit application
├── parser/
│   └── code_parser.py  # AST parsing logic
├── visualizer/
│   └── graph_builder.py # Graph generation
├── templates/
│   └── code_graph.html # Visualization template
├── requirements.txt    # Dependencies
└── README.md          # Documentation