🚀 GitHub Portfolio Analyzer & Enhancer

Turn your GitHub repositories into recruiter-ready proof. Get objective scores, actionable insights, and recommendations to improve your portfolio.

🌐 Deployment

Deployed on Railway platform:

Project LINK: github-portfolio-analyzer

✨ Features

• Instant Analysis: Analyze any public GitHub profile in under 2 minutes
• Portfolio Score: Get an objective score (0-100) based on 6 key metrics
• Recruiter Perspective: Understand what recruiters notice first
• Actionable Recommendations: Get specific, prioritized improvement suggestions
• Visual Dashboard: Clean, intuitive interface with detailed metrics
• Real-time Insights: Analyze documentation quality, commit patterns, and project structure

🎯 Scoring Dimensions

The analyzer evaluates profiles across 6 key dimensions:

1. Documentation Quality (25%) - README files, comments, project descriptions
2. Code Structure (20%) - Organization, essential files, best practices
3. Activity Consistency (20%) - Commit frequency, development patterns
4. Repository Organization (15%) - Profile completeness, pinned repos
5. Project Impact (10%) - Stars, forks, community engagement
6. Technical Depth (10%) - Language diversity, technical breadth

🏗️ Tech Stack

• Backend: Python, Flask
• Frontend: HTML, CSS, JavaScript (Vanilla)
• API: GitHub REST API v3
• Deployment: Configured for Railway

📦 Installation

Prerequisites

• Python 3.8 or higher
• Git

Local Setup

1. Create virtual environment (recommended)

python -m venv venv

# On Windows
venv\Scripts\activate

# On macOS/Linux
source venv/bin/activate

2. Install dependencies

pip install -r requirements.txt

3. Run the application

python app.py

4. Open in browser

http://localhost:5000

🎓 Made for Students

This tool is specifically designed to help students and early-career developers:

• Understand recruiter perspectives
• Identify portfolio gaps
• Get concrete improvement steps
• Build recruiter-ready profiles

🤝 Contributing

Contributions are welcome! Ideas for improvements:

• Add caching to reduce API calls
• Compare with similar profiles
• Generate downloadable PDF reports
• Add more granular code quality checks
• Integration with LinkedIn
• Historical score tracking

📄 License

MIT License - feel free to use and modify for your needs.

📧 Contact

For questions or feedback:

• Email: nityamm2005@gmail.com

---

Thank You!
Coding Today, Engineering Tomorrow!

Made By- Nityam Mishra