github-explorer
Discover GitHub developers and repositories with style
A powerful CLI tool that provides comprehensive information about GitHub users and their repositories with a beautiful, color-coded interface.
github-explorer - a powerful CLI tool that provides comprehensive information about GitHub users and their repositories with a beautiful, color-coded interface. Discover GitHub developers and repositories with style.
- 📊 User Information - Get detailed profile information including bio, company, location, join date, and statistics
- 📚 Repository Browser - Browse all public repositories with stars, forks, languages, and last update dates
- 📈 Statistics Dashboard - View aggregated statistics including total stars, total forks, average stars per repo, and top programming languages
- 🔍 Full User Overview - Combined view of user profile plus 5 most recently updated repositories
- 🏆 Top Starred Repository - Find the most popular repository of any GitHub user
Visual Features:
- 🎨 Color-coded output with Bootstrap-inspired palette
- 📦 ASCII art banner with stylized "GITHUB" logo
- 🔲 Clean box layouts for structured data display
- 📊 Language distribution bars for quick insights
- 🖥️ Responsive design that adapts to terminal width
API Capabilities:
Uses GitHub's public REST API v3 to fetch: user profiles, repository metadata, activity statistics, and creation timestamps.
Prerequisites: Python 3.7+, Internet connection
# Clone the repository git clone https://github.com/aixandrolab/github-explorer.git cd github-explorer # Install dependencies pip install -r requirements.txt # Run the application python app.py
Project Structure:
github-explorer/
│
├── app.py # Main entry point
├── requirements.txt # Dependencies
├── README.md # Documentation
├── LICENSE # BSD 3-Clause License
│
└── utils/
├── __init__.py
├── colors.py # Terminal color definitions
└── github_explorer.py # Core application logic
Main Menu:
╔══════════════════════════════════════════════════════╗ ║ ██████╗ ██╗████████╗██╗ ██╗██╗ ██╗██████╗ ███████╗ ║ ██╔════╝ ██║╚══██╔══╝██║ ██║██║ ██║██╔══██╗██╔════╝ ║ ██║ ███╗██║ ██║ ███████║██║ ██║██████╔╝█████╗ ║ ██║ ██║██║ ██║ ██╔══██║██║ ██║██╔══██╗██╔══╝ ║ ╚██████╔╝██║ ██║ ██║ ██║╚██████╔╝██████╔╝███████╗ ║ ╚═════╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝ ║ ║ GitHub Explorer v1.0.0 - Discover developers & repositories ╠══════════════════════════════════════════════════════╣ ║ 1. 📊 Get user information ║ ║ 2. 📚 Get user repositories ║ ║ 3. 📈 Show statistics dashboard ║ ║ 4. 🔍 Full user overview ║ ║ 5. 🏆 Top starred repository ║ ║ 0. 🚪 Exit ║ ╚══════════════════════════════════════════════════════╝ ➜ Select option:
1. 📊 Get User Information
Displays detailed profile information: basic info, professional details, statistics, account dates, and bio.
╔══════════════════════════════════════════════════════╗ ║ 📊 USER INFORMATION ║ ╠══════════════════════════════════════════════════════╣ ║ 👤 Name: user ║ ║ 🔖 Login: user ║ ║ 📦 Repos: 8 📝 Gists: 8 ║ ║ 👥 Followers: 5 Following: 9 ║ ╚══════════════════════════════════════════════════════╝
2. 📚 Get User Repositories
Lists all public repositories with name, description, URL, stars, forks, language, and last update date.
3. 📈 Statistics Dashboard
Shows aggregated analytics: total stars, total forks, average stars per repo, and top 3 programming languages with visual bars.
4. 🔍 Full User Overview
Combines user profile information with 5 most recently updated repositories.
5. 🏆 Top Starred Repository
Finds and displays the user's most popular repository with name, star count, fork count, URL, and description.
| Color | Usage |
|---|---|
| 🔵 Cyan | Borders, menu frames |
| 🟣 Magenta | Statistics dashboard, accent |
| 🟢 Green | Positive metrics (repos, followers, success) |
| 🟡 Yellow | Warnings, stars, highlights |
| 🔴 Red | Errors, exit option |
| ⚪ White | Headers, important text |
| 🩶 Gray | Secondary information, timestamps |
| 💙 Blue | Logo, fork icons |
By using this software, you agree to the full disclaimer terms.
Software provided "AS IS" without warranty. You assume all risks for file operations, deletions, and system interactions.
Full legal disclaimer: See DISCLAIMER.md
License: BSD 3-Clause License