CodeInsight

Developed by Happy Kumar

CodeInsight is a full-stack GitHub Repository Intelligence Platform built using React, TypeScript, Node.js, Express, Gemini AI, and GitHub APIs.

The platform helps developers understand GitHub repositories through repository analytics, contributor insights, AI-generated summaries, and AI-powered codebase Q&A.

---

Features

📦 Repository Analysis

• Analyze any public GitHub repository
• Fetch repository metadata
• View repository statistics
• Repository language insights
• Open issue tracking

👥 Contributor Analytics

• Fetch top contributors
• Contribution count analysis
• Contributor profile information
• Community activity insights

🤖 AI Repository Summary

• AI-generated repository overview
• Architecture explanations
• Key feature extraction
• Technology stack identification
• Project purpose analysis

💬 AI Codebase Q&A

• Analyze repository structure and source code using GitHub APIs
• Ask natural language questions about the codebase
• Generate context-aware AI responses powered by Gemini
• Understand project architecture, workflows, and implementation details
• Extract insights from repository files without local cloning
• Identify key modules, services, and code organization patterns

---

Tech Stack

Frontend

• React
• TypeScript
• Vite
• Tailwind CSS
• Axios
• React Router DOM
• Lucide React

Backend

• Node.js
• Express.js
• GitHub REST API
• Simple Git

AI

• Gemini 2.5 Flash
• Repository Context Analysis
• AI Summarization
• Codebase Question Answering

---

Prerequisites

Before running the project, ensure you have:

• Node.js
• Git
• GitHub Personal Access Token
• Gemini API Key

---

Installation

Clone Repository

git clone https://github.com/ImHappyKumar/code-insight.git

cd code-insight

---

Backend Setup

cd server
npm install

---

Frontend Setup

cd client
npm install

---

Environment Variables

Create the following files before running the project.

Backend (backend/.env.example)

PORT=5000
GITHUB_TOKEN=your_github_personal_access_token
GEMINI_API_KEY=your_gemini_api_key
ALLOWED_ORIGINS=http://localhost:5173,http://localhost:3000

Frontend (frontend/.env.example)

VITE_API_URL=your_server_url

Rename .env.example to .env after adding your values.

---

Usage

Start Backend

cd server
npm start

Start Frontend

cd client
npm run dev

Open:

http://localhost:5173

---

API Overview

Analyze Repository

GET /github/analyze

Query Parameters:

owner
repo

---

Contributors

GET /github/contributors

Query Parameters:

owner
repo

---

AI Summary

GET /github/summary

Query Parameters:

owner
repo

---

Ask Codebase AI

POST /repository/ask

Request:

{
  "repoUrl": "https://github.com/facebook/react",
  "question": "How is state managed?"
}

Response:

{
  "success": true,
  "answer": "React manages state using hooks such as useState and useReducer."
}

---

Contributing

Contributions are welcome.

If you find a bug or have a feature suggestion, feel free to open an issue or submit a pull request.