🐍 Python Repositories Explorer

A powerful Python tool that fetches and visualizes the most-starred Python repositories from GitHub using the GitHub API. Get insights into trending Python projects with interactive charts and comprehensive repository information.

✨ Features

• 🔍 Smart Repository Search: Fetches top Python repositories sorted by stars
• 📊 Interactive Visualizations: Beautiful Plotly charts with hover information
• 🎯 Comprehensive Data: Repository details including stars, owners, descriptions, and URLs
• 🔗 Clickable Links: Direct links to repositories in visualizations
• 📈 Real-time Data: Always up-to-date information from GitHub API

🚀 Quick Start

Prerequisites

• Python 3.7+
• GitHub Personal Access Token (for higher API rate limits)

Installation

1. Clone the repository

   git clone https://github.com/sanajjadhav15/Python-Repositories-Explorer.git

2. Install dependencies

   pip install requests python-dotenv plotly

3. Set up environment variables Create a .env file in the root directory:

   GITHUB_TOKEN=your_github_token_here

Usage

Run the Jupyter notebook:

jupyter lab python_repos.ipynb

Or run as a Python script:

python python_repos.py

🔧 Configuration

GitHub Token Setup

1. Go to GitHub Settings > Developer settings > Personal access tokens
2. Generate a new token with public_repo scope
3. Add it to your .env file

Customization Options

• Repository Count: Modify the API call to fetch more repositories
• Sorting Options: Change sorting criteria (stars, forks, updated)
• Language Filter: Explore repositories in other programming languages
• Visualization Style: Customize Plotly chart appearance

📊 Sample Output

The tool provides:

• Repository Statistics: Total count, stars, forks, and more
• Interactive Bar Chart: Hover for detailed information
• Clickable Repository Links: Direct navigation to GitHub repositories
• Owner Information: Repository maintainers and organizations

🎨 Visualization Features

• Responsive Design: Charts adapt to different screen sizes
• Hover Information: Detailed repository info on hover
• Clickable Elements: Direct links to GitHub repositories
• Professional Styling: Clean, modern chart appearance

🛠️ API Integration

This project uses the GitHub Search API:

• Endpoint: https://api.github.com/search/repositories
• Query Parameters: q=language:python&sort=stars
• Rate Limiting: Respects GitHub API rate limits
• Authentication: Uses personal access tokens for higher limits

📈 Data Structure

Each repository object contains:

• name: Repository name
• owner: Owner information
• stargazers_count: Number of stars
• description: Repository description
• html_url: GitHub repository URL
• created_at: Creation date
• updated_at: Last update date

🙏 Acknowledgments

• GitHub API for providing repository data
• Plotly for interactive visualizations
• Python community for amazing open-source projects