https://github.com/kyprexs/github-profile-analyzer
A modern, visually appealing command-line tool to analyze any public GitHub user's profile and repositories. Summarizes stars, forks, and languages, and exports results to JSON, CSV, or Markdown. Easy to use, secure, and perfect for developers, recruiters, and data enthusiasts.
https://github.com/kyprexs/github-profile-analyzer
command-line-tool data-visualization developer-tools github github-api open-source profile-analyzer python repo-stats
Last synced: 20 days ago
JSON representation
A modern, visually appealing command-line tool to analyze any public GitHub user's profile and repositories. Summarizes stars, forks, and languages, and exports results to JSON, CSV, or Markdown. Easy to use, secure, and perfect for developers, recruiters, and data enthusiasts.
- Host: GitHub
- URL: https://github.com/kyprexs/github-profile-analyzer
- Owner: kyprexs
- License: mit
- Created: 2025-05-12T08:24:26.000Z (20 days ago)
- Default Branch: main
- Last Pushed: 2025-05-12T08:37:02.000Z (20 days ago)
- Last Synced: 2025-05-12T09:55:19.910Z (20 days ago)
- Topics: command-line-tool, data-visualization, developer-tools, github, github-api, open-source, profile-analyzer, python, repo-stats
- Language: Python
- Homepage:
- Size: 56.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GitHub Profile Analyzer
A modern, visually appealing command-line tool to analyze any public GitHub user's profile and repositories.
## Features
- Fetches and displays GitHub user profile info (name, followers, bio, etc.)
- Summarizes repository stats (total stars, forks, most used languages)
- Shows top 3 languages used
- Beautiful, colorized console output
- Export results to JSON, CSV, or Markdown
- Handles API rate limits and errors gracefully
- Easy to use and extend
## Setup
1. **Clone the repository:**
```sh
git clone https://github.com/yourusername/github-profile-analyzer.git
cd github-profile-analyzer
```
2. **Install dependencies:**
```sh
pip install -r requirements.txt
```
3. **(Optional but recommended) Add a GitHub token:**
- Create a `.env` file in the project root:
```
GITHUB_TOKEN=your_github_token_here
```
- [Generate a token here](https://github.com/settings/tokens) (no scopes needed for public data).
- **Security Note:** _You will **never** be asked to enter your token in the terminal. The tool only uses the token if it is present in your `.env` file or as an environment variable. Your token is never uploaded or shared._
## Usage
Analyze a GitHub user in the console:
```sh
python main.py
```
Show more details (URLs, etc.):
```sh
python main.py --verbose
```
Export to JSON, CSV, or Markdown:
```sh
python main.py --format json --output result.json
python main.py --format csv --output repos.csv
python main.py --format md --output report.md
```
> **Note:** If you do not provide a token, the tool will still work for public data, but with lower rate limits (60 requests/hour per IP). For best results, add your own token to `.env`.
## Example Output
## Contributing
Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.
## License
[MIT](LICENSE)