Open Source Contributions

A CLI tool and OSS portfolio — featuring gitstat, a utility that turns any GitHub repo into a beautiful analytics report.

gitstat is a zero-dependency Python CLI that takes a GitHub repo URL and generates a comprehensive HTML (or Markdown) analytics report. No API token required for public repos.

• Stars, forks, open issues, watchers at a glance
• Top contributors with avatars and commit counts
• Recent commits with SHA, author, message, and date
• Language breakdown with visual bars
• Repo metadata: license, branch, dates, size
• Rate-limit aware API calls with caching
• HTML reports with clean, responsive design
• Markdown reports for embedding in docs

pip install gitstat

# Or from source
git clone https://github.com/roohan-514/open-source-contributions.git
cd open-source-contributions
pip install -e .

# Basic
gitstat https://github.com/roohan-514/rag-chatbot-system

# Custom output
gitstat https://github.com/roohan-514/rag-chatbot-system -o report.html

# Markdown format
gitstat https://github.com/roohan-514/rag-chatbot-system -f markdown

# Verbose mode
gitstat https://github.com/roohan-514/rag-chatbot-system --verbose

The HTML report includes:

• Repository overview with stats cards
• Top contributors section with profile links
• Commit history table
• Language distribution bar chart (pure CSS)
• Full metadata footer

I built gitstat to scratch my own itch — I wanted a quick way to generate shareable repo analytics without opening the GitHub UI. Then I turned it into a showcase of OSS contribution practices.

Bug reports, feature requests, and PRs are welcome. Check CONTRIBUTING.md to get started.

MIT