AI-Powered Repository Intelligence, Code Quality Analysis, and Architecture Visualization Platform
RepoGPT is a production-grade developer SaaS platform designed to ingest, parse, index, and visualize public GitHub repositories. By combining Abstract Syntax Tree (AST) parsing, directory structural walking, node-link graph mapping, and localized Retrieval-Augmented Generation (RAG), RepoGPT transforms dense codebases into interactive, queryable developer workspaces.
The platform acts as a virtual "AI Senior Engineer," enabling developers to immediately onboard onto unfamiliar repositories, audit code quality, generate premium PDF reports, and explore visual software architectures in real-time.
- Eliminate Onboarding Friction: Shorten developer ramp-up time by automatically extracting project purposes, technical workings, routing endpoints, and setup requirements.
- Deep Code Auditing & Intelligence: Automatically scan code for security vulnerabilities, duplication rates (code originality), maintainability, and structural complexity.
- Demystify Complex Architectures: Turn abstract text codebases into interactive flow-graph diagrams representing internal modules, service integrations, and query channels.
- Generate Premium Reports: Provide instant, exportable PDF executive summaries with deep data visualizations for stakeholders.
- Secure and Local-Ready Code Intel: Empower developers to query codebases semantically without forced subscriptions or uploading proprietary data structures to third-party cloud engines.
RepoGPT is built on a modern Next.js stack, using dynamic serverless routing matched to an offline-first JSON-based state indexing store.
- Live GitHub API Orchestration: Before cloning, RepoGPT securely queries the live GitHub REST API to pull 100% accurate, paginated metadata (Total Commits, Contributors, Branches, Last Active Dates) to ensure data parity with GitHub's live dashboard.
- Blobless Git Cloning: Rather than executing slow full clones, RepoGPT performs a shallow clone with
--filter=blob:none. This downloads only files metadata at checkout and loads actual file contents lazily on-demand, cutting ingestion bandwidth by up to 90%. - AST Symbol Resolution & Scoring: The parser scans source files (JS, TS, Python, Go, Rust, Java, C++, PHP) extracting exports, imports, class declarations, and function modules. Simultaneously, it scores files for Complexity and Code Smells.
- Originality & Security Engines: Scans the codebase to detect duplicated lines and blocks (Code Originality) and flags Critical, High, and Medium security risks based on pattern matching.
- Link-Node Dependency Mapping: Discovered imports are resolved to project-relative files, building a node-link visualization representation map where files represent nodes and imports represent directed graph links.
- Semantic Indexing: Files are chunked using a sliding window algorithm (150 lines per chunk, 30 lines overlap) and stored inside a local indexing mapping for fast semantic/keyword lookup.
- Dynamic Data Visualization: Powered by
Recharts, the dashboard presents premium pie charts, gauge graphs, and stacked bar charts visualizing Language Distribution, Security Vulnerabilities, and Code Originality. - Executive PDF Reporting: Uses
jsPDFandjspdf-autotableto generate stunning, dark-mode, multi-page PDF reports on the fly, complete with custom image banners, embedded data visualizations, and executive summaries.
- Powered by
React Flow, it maps codebase relationships into customizable web-canvas graphs. - Automatically distinguishes core components, database files, routers, middleware, and logic files.
- Allows pan, zoom, and node searches, showing file summaries on-click. Includes specialized filters for File Trees and Core Flows.
- An interactive chat copilot that answers questions about the codebase structure.
- Supports Ollama locally, auto-connecting to user models like
deepseek-coder,llama3, ormistral. - Falls back gracefully to localized keyword/vector mapping if Ollama is offline.
- Provides persistent suggested query capsules right above the input bar for easy template testing.
- Renders instant developer onboarding manuals, setup instructions, REST route tables, and API documentation based on structural scanning.
- Uses a strictly tracked, rolling 24-hour JSON tracking system.
- Grants users a limit of 5 deep scans per device per 24 hours, automatically pruning older scans to ensure perfect zero-bloat state tracking.
To ensure context-aware AI retrieval, files are chunked as follows:
- Size: 150 lines per chunk (prevents LLM token overflow while retaining contextual code blocks).
- Overlap: 30 lines (ensures continuity of functions and class structures splitting across boundaries).
- Identifier Format:
${relativePath}:${startLine}-${endLine}for precise file references.
When a user queries the semantic chat:
- Local Retrieval (Fallback): Calculates keyword overlap and matching coefficients against index chunks, ranking chunks containing the highest density of matching symbols, functions, or imports.
-
Ollama Retrieval: If Ollama is online, queries are processed using contextual codebase chunks injected into the system prompt to guide LLM synthesis:
$$\text{Score}(c, q) = \sum_{t \in q} \text{TF-IDF}(t, c) \cdot \text{Priority}(c)$$
| Component | Technology | Role |
|---|---|---|
| Framework | Next.js 16 (App Router) | Core platform runtime & serverless endpoints |
| Styling | Vanilla CSS + Tailwind | Fluid UI components, glassmorphism dashboard |
| Data Viz | Recharts | Dynamic SVG charting for code quality |
| PDF Engine | jsPDF + autoTable | Real-time premium executive report generation |
| State & Store | Node fs + JSON Store | Local indexing and cache layer (src/lib/storage.ts) |
| Graphing Engine | React Flow | Interactive node-link canvas rendering |
| Markdown Parser | Marked | Dynamic rendering of AI responses |
Tip
Performance Optimization: By omitting binary blobs during git checkout and leveraging live GitHub API data for metadata, ingestion times and data accuracy are strictly optimized.
- 100% Client-Safe: Integrates with local Ollama APIs, ensuring zero external code storage or corporate data leakage.
- Premium UX/UI: The interface features sleek glassmorphism, dynamic Recharts micro-animations, and beautifully structured PDF exports.
- Self-Healing Storage: The backend strictly monitors rolling 24-hour limits and prunes dead files to ensure the engine never bloats.
Warning
Static Parsing Boundaries: Codebase mapping uses AST regex scans. Dynamic operations like database triggers or reflection APIs are not trace-mapped.
- Resource Intensive: Running heavy local models in Ollama requires appropriate CPU/GPU system resources.
- Public Git Restriction: Only works with publicly accessible GitHub URLs by default (private repositories require pre-configured SSH keys or credentials).
- Private Repository Authentication: Add OAuth2 integration to allow secure analysis of private workspaces.
- 3D WebGL Visualization: Migrate architecture graphs to Three.js force-directed networks to accommodate large enterprise repositories.
- Write-Back Agent Capabilities: Enable developers to request automated refactoring and pull-request creation directly from the chat.
- CI/CD Integration: Provide a RepoGPT GitHub Action to generate static documentation sites and PDF audit reports automatically during builds.
RepoGPT bridges the gap between text-based codebases and developer mental models. Through optimized cloning, live GitHub API polling, rich data visualization, and local semantic intelligence, the platform allows developers to analyze, audit, and interact with complex software projects seamlessly. Whether used for immediate codebase onboarding or generating premium executive quality reports, RepoGPT serves as a secure, local-first workspace for modern repository intelligence.