📊 GitHub Analytics

GitHub Contribution Tracker & Analyzer
Track, analyze, and predict your GitHub contributions with insightful metrics, beautiful charts, and dynamic achievements!

GitHub Contribution Tracker is a powerful Streamlit web application designed to visualize your GitHub user contributions. By leveraging the GitHub GraphQL API, it fetches and displays a detailed history of your contributions, enabling you to track, analyze, and boost your open-source growth.

ℹ️ Now features Machine Learning to predict user contribution over a year using previous year's contribution data!

🚀 Features

📈 User Stats Overview

• 🧑‍💻 User Stats:

  • Total contributions across all repositories (Now shows no. of private and public commits).
  • Highest contributions in a single day (Now shows date).
  • Current streak of consecutive contribution days.
  • Longest streak of consecutive contribution days.
  • GitHub joining date, total no. of days on GitHub and no. of active days.

• 📅 Yearly Growth Stats:

  • Total contribution in previous year
  • Rate of contribution
  • No. of activate days
  • Percentage of days active in the year
  • Same for current year for comparison

• 📊 Visualizations:

  • Contributions Over Time: A line chart showing daily contributions.
  • Yearly Growth: A bar chart summarizing contributions year by year.
  • Day-of-Week Analysis: Contributions grouped by the day of the week.
  • Weekday vs. Weekend Contributions: A bar chart comparing contributions made on weekdays versus weekends.
  • Programming Languages: Pie chart and a table showing which programming languages are used and in how many repos

• 🏆 Achievements:

  • Dynamic achievements unlocked based on contribution and streak activity, such as:
    • "🔥 Streak Warrior": A streak of over 30 days.
    • "💪 Commit Master": Total contributions exceeding 1000.

🔮 User Contribution Predictions

• 📈 Predictions & Trends:

  • Contribution Rate Growth: Growth in contribution rate compared to last year
  • Predicted Contributions This Year: Total predicted commits this year, if user continues to contribute at the same rate
  • Predicted Active Days This Year: Total predicted active days this year, if user continues to contribute at the same rate

• 🎯 Milestone Estimations:

  Predicts for milestones [100, 500, 1000, 2000, 5000, 10000] contributions:

  • Number of days required to achieve commit milestones
  • Date on which milestone will be achieved

---

🛠️ Installation

📋 Prerequisites

1. 🐍 Python 3.7 or higher.
2. 🔑 GitHub personal access token with GraphQL API access.
3. 🌐 Streamlit (pip install streamlit).

⚙️ Setup Instructions

1. Clone the repository:

   git clone https://github.com/ishandutta2007/GitHub-Analytics.git
   cd GitHub-Analytics

2. Set up a virtual environment (Optional but recommended):

   Using venv:

   python -m venv venv
   source venv/bin/activate  # On Windows, use `venv\Scripts\activate`

   Alternatively, using pyenv:

   pyenv virtualenv github-analytics-env
   pyenv activate github-analytics-env

3. Install dependencies:

   pip install -r requirements.txt

4. Run the app:

   streamlit run app.py

5. Open your browser and navigate to the URL shown in the terminal (usually http://localhost:8501).

---

💡 Usage

1. Enter your GitHub Username.
2. Provide a GitHub Personal Access Token (with read:user and repo scopes for GraphQL API access).
3. View detailed stats, visualizations, and achievements based on your contribution data.

🔑 How to Generate a GitHub Personal Access Token

1. Go to GitHub Developer Settings.
2. Click on Generate new token (classic) or Generate token (for fine-grained).
3. Select the following scopes:
   • repo
   • read:user
4. Copy the generated token and use it in the app.

---

📂 Folder Structure

github-contribution-tracker/
├── github_stats.py         # Logic for fetching and processing GitHub contribution data.
├── app.py                  # Streamlit app for displaying the dashboard.
├── requirements.txt        # Python dependencies.
└── README.md               # Project documentation.

---

🔮 Future Improvements

• 🏅 Add achievements in form of badges.
• 📦 Include repository-specific stats (e.g., most active repositories).
• 🗓️ Display contributions grouped by month.
• 👥 Add user rankings for team or organization collaboration.

---

📸 Screenshots

Click to View Images 📷

---

🤝 Contributing

Contributions are welcome! To contribute:

1. Fork the repository.
2. Create a feature branch: git checkout -b feature/your-feature.
3. Commit changes: git commit -m 'Add your feature'.
4. Push to your fork: git push origin feature/your-feature.
5. Create a pull request.

---

📄 License

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

---

🙏 Acknowledgements

• Streamlit: For building the interactive web application.
• GitHub GraphQL API: For data fetching.

---

✨ Star History