File size: 1,088 Bytes
75d1bc8
 
 
 
 
 
 
 
 
94dca4d
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
---
title: Codebase Explainer
emoji: πŸ”
colorFrom: blue
colorTo: green
sdk: docker
app_file: app.py
pinned: false
---

# πŸ” AI Codebase Explainer

> Ask questions about any GitHub repository in plain English. No more reading 50 files manually.

## πŸš€ Live Demo
πŸ‘‰ [Try it here](https://huggingface.co/spaces/Krishp1/codebase-explainer)

## πŸ“Š Benchmark Results (psf/requests)
| Metric | Result |
|--------|--------|
| Files indexed | 46 files |
| Chunks created | 341 chunks |
| Ingestion time | 15.45 seconds |
| Vector DB latency | ~100ms |
| Accuracy | 4/5 questions βœ… |

## πŸ› οΈ Tech Stack
- LangChain + RAG pipeline
- ChromaDB (vector store)
- HuggingFace Embeddings (all-MiniLM-L6-v2)
- Groq LLaMA 3 (LLM)
- Streamlit (UI)
- Docker + HuggingFace Spaces (deployment)

## πŸ’‘ How It Works
1. Paste any GitHub repo URL
2. App clones and indexes all code files
3. Ask questions in plain English
4. Get answers with source file citations

## 🎯 Use Cases
- Understand a new codebase in minutes
- Onboard to a new company faster
- Explore open source projects instantly