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

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages