Skip to content

AreefRasool/DevScope-AI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎯 DevScope AI — GitHub Portfolio Intelligence Platform

DevScope AI analyzes any public GitHub profile the way a technical recruiter would — pulling repository data, scoring portfolio quality, and turning it into a clean, visual report card. Just enter a username and get an instant A+ to F grade, a breakdown of language diversity, top repositories, documentation quality, and activity trends, all rendered in an interactive Gradio dashboard powered by Plotly analytics.

Built for developers who want an honest, data-driven look at how their GitHub profile would actually read to a hiring manager.

Status Python Gradio GitHub API


🎯 Features

  • 🔍 GitHub Profile Analysis — Pulls live profile data directly from the GitHub REST API.
  • 📦 Repository Analytics — Breaks down every public repo by stars, forks, and language.
  • 🏆 Portfolio Scoring System — Converts raw GitHub stats into a single, weighted portfolio score.
  • 🎓 Recruiter-Style Grades — Translates the score into familiar grades (A+, A, B, C...).
  • 🧩 Language Distribution Analysis — Visualizes the tech stack spread across all repositories.
  • ⭐ Top Repositories by Stars — Surfaces the profile's strongest, most-starred projects.
  • 👥 Followers & Activity Tracking — Tracks community reach and recent contribution activity.
  • 📄 Documentation Quality Assessment — Checks for README presence and quality across repos.
  • 🎨 Project Diversity Evaluation — Rewards varied, well-rounded project portfolios over repetition.
  • 📊 Interactive Plotly Charts — Fully interactive visual analytics, not static images.
  • 🖥️ Modern Gradio Dashboard — Clean, recruiter-friendly UI for sharing or demoing live.

📸 Preview

Dashboard

Dashboard

Portfolio Analysis

Analysis

Analytics Charts

Charts


🖥️ Tech Stack

Tool Purpose
Gradio Interactive web dashboard
Plotly Data visualization & charts
Pandas Data wrangling & analysis
Requests GitHub REST API calls
GitHub REST API Source of profile & repo data
Python 3.9+ Core logic

🚀 Getting Started

1. Clone the repository

git clone https://github.com/<your-username>/<repo-name>.git
cd <repo-name>

2. Install dependencies

pip install -r requirements.txt

Or directly:

pip install gradio requests pandas plotly

3. Run the app

python app.py

The app will launch locally and also generate a shareable public link via Gradio's share=True.

💡 Running in Google Colab / Kaggle? Upload app.py, install dependencies with !pip install gradio requests pandas plotly, then run the script — Gradio will give you a public shareable link.


🧠 How It Works

  1. Enter a GitHub username
  2. Fetch profile and repository data via the GitHub REST API
  3. Analyze portfolio quality across multiple weighted factors
  4. Generate a recruiter-style score and letter grade
  5. Display insights, charts, and a full analytics breakdown

📐 Scoring Factors

The portfolio score is calculated from a weighted mix of:

  • Repository Count
  • GitHub Stars
  • Followers
  • Technology Diversity
  • Documentation Quality
  • README Presence
  • Project Diversity
  • Recent Activity

📊 Example Output

Portfolio Score: 95 / 100
Grade: A+

Metrics:
- Repositories : 24
- Followers    : 132
- Stars        : 410
- Forks        : 58
- Languages    : 7

📌 Future Improvements

  • 🤖 AI-powered career recommendations based on profile gaps
  • 📄 Resume analysis and GitHub-to-resume matching
  • 📝 Deeper README quality scoring (structure, completeness, badges)
  • 📈 Contribution graph & commit-streak analysis
  • 🤝 Team collaboration scoring for org-based contributors

👤 Author

Areef Rasool

BSAI Student | AI, Development & Networking Enthusiast

Built with Python, Gradio, and the GitHub REST API.


📄 License

This project is open-source and available under the MIT License.

About

AI-powered GitHub Portfolio Intelligence Platform that analyzes repositories, stars, followers, activity, languages, documentation quality, and generates recruiter-style portfolio scores.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages