Skip to content

aixandrolab/github-explorer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚀 GitHub Explorer v1.0.0

GitHub release (latest by date) GitHub top language GitHub GitHub stars GitHub forks

Discover GitHub developers and repositories with style


⚠️ Disclaimer

By using this software, you agree to the full disclaimer terms.

Summary: Software provided "AS IS" without warranty. You assume all risks for file operations, deletions, and system interactions.

Full legal disclaimer: See DISCLAIMER.md


✨ Features

GitHub Explorer is a powerful CLI tool that provides comprehensive information about GitHub users and their repositories with a beautiful, color-coded interface.

Core Features

  • 📊 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 (name, bio, company, location, email, blog, social links)
  • Repository metadata (description, stars, forks, language, update dates)
  • Activity statistics (followers, following, public repos, gists)
  • Creation and last update timestamps

📦 Installation

Prerequisites

  • Python 3.7 or higher
  • Internet connection (for GitHub API)

Quick Start

  1. Clone the repository
git clone https://github.com/aixandrolab/github-explorer.git
cd github-explorer
  1. Install dependencies
pip install -r requirements.txt

Or manually:

pip install requests
  1. 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
├── .gitignore           # Git ignore rules
│
└── utils/
    ├── __init__.py
    ├── colors.py         # Terminal color definitions
    └── github_explorer.py # Core application logic

🎮 Usage

Main Menu

When you launch the application, you'll see an interactive menu:

══════════════════════════════════════════════════════════
    ██████╗ ██╗████████╗██╗  ██╗██╗   ██╗██████╗ ███████╗
   ██╔════╝ ██║╚══██╔══╝██║  ██║██║   ██║██╔══██╗██╔════╝
   ██║  ███╗██║   ██║   ███████║██║   ██║██████╔╝█████╗  
   ██║   ██║██║   ██║   ██╔══██║██║   ██║██╔══██╗██╔══╝  
   ╚██████╔╝██║   ██║   ██║  ██║╚██████╔╝██████╔╝███████╗
    ╚═════╝ ╚═╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝

   GitHub Explorer v1.0.0 — Discover developers & repositories
────────────────────────────────────────────────────────

┌──────────────────────────────────────────────────┐
│ MAIN MENU                                        │
├──────────────────────────────────────────────────┤
│ 1. 📊 Get user information                       │
│ 2. 📚 Get user repositories                      │
│ 3. 📈 Show statistics dashboard                  │
│ 4. 🔍 Full user overview                         │
│ 5. 🏆 Top starred repository                     │
│ 0. 🚪 Exit                                       │
└──────────────────────────────────────────────────┘

➜ Select option:

Menu Options Explained

1. 📊 Get User Information

Displays detailed profile information for a GitHub user:

  • Basic info (name, login, ID)
  • Professional details (company, location, email, blog)
  • Statistics (repos, gists, followers, following)
  • Account dates (joined, last updated)
  • Bio (if available)

Example output:

╔══════════════════════════════════════════════════════╗
║  📊 USER INFORMATION                                 ║
╠══════════════════════════════════════════════════════╣
║ 👤 Name:        user                                 ║
║ 🔖 Login:       user                                 ║
║ 🆔 ID:          123123                               ║
║ 📦 Repos:        8     📝 Gists:        8            ║
║ 👥 Followers:    5    Following:        9            ║
╚══════════════════════════════════════════════════════╝

2. 📚 Get User Repositories

Lists all public repositories with detailed information:

  • Repository name and description
  • Direct GitHub URL
  • Star and fork counts
  • Primary programming language
  • Last update date

3. 📈 Statistics Dashboard

Shows aggregated analytics across all repositories:

  • Total stars across all repos
  • Total forks across all repos
  • Average stars per repository
  • Top 3 programming languages with visual bars

4. 🔍 Full User Overview

Combines options 1 & 2:

  • Complete user profile information
  • 5 most recently updated repositories

5. 🏆 Top Starred Repository

Finds and displays the user's most popular repository:

  • Repository name
  • Star and fork counts
  • Direct URL
  • Description (if available)

0. 🚪 Exit

Exits the application with a goodbye message and copyright notice.


🎨 Color Scheme

The application uses a carefully chosen color palette:

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

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📄 License

Copyright © 2026, Alexander Suvorov. All rights reserved.

This project is licensed under the BSD 3-Clause License - see the LICENSE file for details.


📧 Contact

Alexander Suvorov – @aixandrolab

Project Link: https://github.com/aixandrolab/github-explorer


Made with ❤️. Made for users

About

GitHub Explorer is a powerful CLI tool that provides comprehensive information about GitHub users and their repositories with a beautiful, color-coded interface.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages