Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

16 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Python FastAPI Azure AI Foundry License

RepoPilot AI ๐Ÿš€

AI-Powered Open Source Intelligence for Contributors

RepoPilot AI helps developers understand unfamiliar GitHub repositories and discover the best way to contribute.

Built for the Microsoft AI Skills Fest Hackathon, RepoPilot AI uses Azure AI Foundry IQ to analyze repositories, explain project structure, evaluate contribution difficulty, and guide beginners toward meaningful first contributions.

Instead of overwhelming contributors with thousands of files, issues, and unfamiliar code, RepoPilot AI transforms repositories into actionable contributor intelligence.


๐Ÿš€ Live Demo

๐ŸŒ Try RepoPilot AI Live: https://repopilot-ai-foundry.onrender.com

๐ŸŽฅ Demo Video

โ–ถ๏ธ Watch Demo Video: https://drive.google.com/file/d/10OUHgPySi6XGPcalq6hmhs91VM3WXVCh/view?usp=sharing


๐ŸŒ Problem Statement

Open source is difficult to enter.

New contributors often struggle with:

  • Understanding large repositories
  • Figuring out what the project actually does
  • Knowing where to start contributing
  • Finding beginner-friendly tasks
  • Understanding folder structures
  • Evaluating repository health
  • Predicting maintainer responsiveness

This causes many developers to abandon open-source contributions before making their first pull request.

Our Solution

RepoPilot AI acts like an AI-powered open-source mentor.

Simply enter a GitHub repository URL and RepoPilot AI will:

โœ… Explain the repository in beginner-friendly language
โœ… Detect technologies automatically
โœ… Recommend where to start contributing
โœ… Analyze repository health
โœ… Suggest first contribution areas
โœ… Explain folder structure
โœ… Provide contribution roadmaps


โœจ Features

๐Ÿ” Repository Intelligence

  • AI-generated repository summaries
  • Beginner-friendly explanations
  • Technology stack detection
  • Repository purpose breakdown
  • Folder structure explanations

๐Ÿง  Contribution Guidance

  • Contribution roadmap generation
  • Beginner difficulty scoring
  • Best files/folders to start exploring
  • Suggested first PR recommendations
  • Contributor onboarding guidance

๐Ÿ“Š Repository Health Analytics

  • Repository health score
  • Maintainer activity analysis
  • Issue health scoring
  • Bus factor risk estimation
  • Community activity indicators

โ˜๏ธ Azure AI Foundry Intelligence

RepoPilot AI uses Microsoft Azure AI Foundry IQ for grounded repository understanding.

Instead of hallucinating, the AI:

  1. Builds a repository knowledge base
  2. Uploads repository context into a vector store
  3. Uses Foundry File Search
  4. Generates grounded explanations using retrieved repository context

This produces more reliable and explainable AI outputs.


๐Ÿ— System Architecture

image

๐Ÿง  How RepoPilot AI Works

Step 1 โ€” Repository Fetching

RepoPilot AI fetches:

  • README content
  • Repository structure
  • Folder hierarchy
  • Issues and contribution signals
  • Maintainer activity data
  • Repository metadata

Step 2 โ€” Repository Analysis

The system detects:

  • Programming languages
  • Frameworks
  • Tech stack
  • Contribution areas
  • Project complexity

Step 3 โ€” Azure AI Foundry IQ

Repository context is uploaded into a Foundry Vector Store.

Using Foundry File Search, the model retrieves grounded repository information before generating explanations.

This prevents hallucinated repository summaries.

Step 4 โ€” Contributor Guidance

RepoPilot AI generates:

  • Beginner-friendly summaries
  • Contribution roadmaps
  • Folder explanations
  • Difficulty assessments
  • Suggested onboarding path

๐Ÿ›  Tech Stack

Backend

  • Python
  • FastAPI
  • Uvicorn

AI & Cloud

  • Microsoft Azure AI Foundry
  • Azure AI Foundry IQ
  • Azure Vector Store
  • Foundry File Search
  • GPT-4.1-mini

Data Sources

  • GitHub REST API
  • GitHub Repository Metadata

Frontend

  • HTML
  • CSS
  • Vanilla JavaScript

Authentication

  • Azure CLI (az login)
  • DefaultAzureCredential()

๐Ÿ“ธ Screenshots

Home Dashboard

image

Repository Analysis Output

image image

Repository Health and Tech Stack

image image

Contribution Roadmap

image image

Maintainer Activity Visualization

image

๐Ÿ“‚ Project Structure

RepoPilot-AI-Web/
โ”‚
โ”œโ”€โ”€ main.py
โ”‚   โ”œโ”€โ”€ FastAPI application
โ”‚   โ””โ”€โ”€ API endpoints
โ”‚
โ”œโ”€โ”€ github_fetcher.py
โ”‚   โ””โ”€โ”€ GitHub REST API client
โ”‚
โ”œโ”€โ”€ repo_analyzer.py
โ”‚   โ”œโ”€โ”€ Tech stack detection
โ”‚   โ””โ”€โ”€ Contribution area analysis
โ”‚
โ”œโ”€โ”€ metrics_analyzer.py
โ”‚   โ””โ”€โ”€ Repository health scoring
โ”‚
โ”œโ”€โ”€ foundry_agent.py
โ”‚   โ”œโ”€โ”€ Azure AI Foundry integration
โ”‚   โ”œโ”€โ”€ Vector store creation
โ”‚   โ”œโ”€โ”€ File Search retrieval
โ”‚   โ””โ”€โ”€ Grounded AI reasoning
โ”‚
โ”œโ”€โ”€ templates/
โ”‚   โ””โ”€โ”€ index.html
โ”‚
โ”œโ”€โ”€ static/
โ”‚   โ”œโ”€โ”€ css/
โ”‚   โ”‚   โ””โ”€โ”€ style.css
โ”‚   โ”‚
โ”‚   โ””โ”€โ”€ js/
โ”‚       โ””โ”€โ”€ app.js
โ”‚
โ”œโ”€โ”€ requirements.txt
โ”œโ”€โ”€ .env.example
โ””โ”€โ”€ README.md

โš™๏ธ Installation & Setup

1. Clone Repository

git clone https://github.com/your-username/RepoPilot-AI-Web.git
cd RepoPilot-AI-Web

2. Create Virtual Environment

python -m venv .venv

Activate environment:

Command Prompt (CMD)

.venv\Scripts\activate

PowerShell

.\.venv\Scripts\Activate.ps1

3. Install Dependencies

pip install -r requirements.txt

4. Configure Environment Variables

Copy environment template:

Windows

copy .env.example .env

Mac/Linux

cp .env.example .env

Add the following:

GITHUB_TOKEN=your_github_token

FOUNDRY_PROJECT_ENDPOINT=https://your-project.services.ai.azure.com/api/projects/your-project

FOUNDRY_MODEL_DEPLOYMENT=gpt-4.1-mini

5. Install Azure CLI

Download Azure CLI:

Azure CLI Download

Verify installation:

az --version

Login:

az login

6. Run Application

uvicorn main:app --reload

Open browser:

http://localhost:8000

๐Ÿ“ก API Documentation

Analyze Repository

GET /api/analyze?repo_url=

Example

GET /api/analyze?repo_url=microsoft/vscode

Returns

{
  "summary": "AI-generated repository summary",
  "health_score": 87,
  "tech_stack": ["TypeScript", "Electron"],
  "folder_explanation": {},
  "contribution_guide": {},
  "maintainer_activity": {},
  "issue_health": {}
}

๐Ÿ’ก Example Use Cases

Beginner Contributors

Understand unfamiliar repositories faster.

Open Source Programs

Useful for:

  • GSoC
  • Hacktoberfest
  • First contributions
  • Community onboarding

Maintainers

Help onboard contributors more efficiently.

Students

Learn repository structure and technologies.


๐Ÿงช Example Workflow

  1. Paste GitHub repository URL
  2. RepoPilot fetches repository data
  3. Azure AI Foundry analyzes repository context
  4. AI generates grounded explanations
  5. User receives contribution roadmap

๐Ÿ”ฎ Future Improvements

  • AI contributor match score
  • Personalized issue recommendations
  • PR success prediction
  • Contributor skill-based onboarding
  • Multi-repository comparison
  • GitHub Copilot integration
  • Repo learning paths

๐Ÿ† Microsoft AI Skills Fest Alignment

RepoPilot AI leverages Microsoft Azure AI Foundry to make open-source contribution more accessible and beginner-friendly.

By combining:

  • GitHub Repository Intelligence
  • Azure AI Foundry IQ
  • Grounded Retrieval
  • Contributor Guidance

RepoPilot AI transforms confusing repositories into actionable contributor intelligence.


๐Ÿ‘จโ€๐Ÿ’ป Team

Aman

Built for the Microsoft AI Skills Fest Hackathon 2026


๐Ÿ“œ License

This project is licensed under the MIT License - see the LICENSE file for details.


About

AI-powered GitHub repository analysis and contributor guidance using Azure AI Foundry IQ, grounded retrieval, and repository intelligence.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages