GitHub Profile Analyzer

A Python-based command-line application that fetches and analyzes GitHub user profile data using the GitHub REST API.

This project demonstrates real-world backend skills such as API integration, JSON handling, error handling, and clean code structure.

---

🚀 Features

• Fetch GitHub user profile details using a username
• Handle invalid usernames gracefully
• Handle network issues and server-side errors
• Display key GitHub statistics:
  • Name
  • Username
  • Public repositories
  • Followers
  • Following
• Save fetched profile data locally in JSON format

---

🛠️ Technologies Used

• Python
• Requests (API calls)
• JSON
• File Handling
• Error Handling

---

GitHub Profile Analyzer

A Python-based command-line application that fetches and analyzes GitHub user profile data using the GitHub REST API.

This project demonstrates real-world backend skills such as API integration, JSON handling, error handling, and clean code structure.

---

🚀 Features

• Fetch GitHub user profile details using a username
• Handle invalid usernames gracefully
• Handle network issues and server-side errors
• Display key GitHub statistics:
  • Name
  • Username
  • Public repositories
  • Followers
  • Following
• Save fetched profile data locally in JSON format

---

🛠️ Technologies Used

• Python
• Requests (API calls)
• JSON
• File Handling
• Error Handling

---

📂 Project Structure

github-profile-analyzer/ ├── main.py ├── profile.json ├── requirements.txt └── README.md

---

⚙️ Installation & Setup

1. Clone the repository:

   git clone https://github.com/your-username/github-profile-analyzer.git
   cd github-profile-analyzer
   

2. Install required dependencies: pip install -r requirements.txt

▶️ How to Run

python main.py Enter a GitHub username when prompted.

📌 Sample Output

GitHub Profile Details
----------------------
Name       : The Octocat
Username   : octocat
Repos      : 8
Followers  : 10000+
Following  : 9

📁 Output File Profile data is saved locally as: profile.json

🎯 Learning Outcomes

1. Working with REST APIs
2. Handling JSON data in Python
3. Writing clean, modular Python code
4. Implementing error handling for real-world scenarios
5. Understanding API status codes and network failures

👨‍💻 Author Sooraj Suresh

📄 License This project is for educational and learning purposes.