A simple Python diagnostic tool to troubleshoot why your GitHub contributions are not showing up in your profile statistics, even though they appear in the contribution graph.

Have you ever experienced this frustrating situation?

• ✅ Your commits appear in the contribution graph (green squares)
• ❌ But they don't count in your total contribution stats
• ❌ Last year's contributions are missing from your profile
• ❌ Your contribution streak is broken despite regular commits

This tool helps you diagnose and fix these issues!

✅ Automated Checks - Runs 5+ critical checks automatically
✅ Scoring System - Shows exactly what passed and what failed with percentage
✅ Progress Bar - Visual progress indicator with 50-character bar
✅ Visual Boxes - Professional boxed messages with borders (╔═══╗)
✅ Numbered Lists - Clear numbered output for passed/failed checks
✅ Clear Solutions - Provides actionable fixes for each issue
✅ Email Verification - Checks if commits use the correct email
✅ Branch Detection - Verifies you're on the default branch
✅ Push Status - Confirms changes are synced with GitHub
✅ Visual Checkboxes - Clear ☑/☐ indicators for completed/pending items
✅ Summary Box - Professional summary with status, action, and progress
✅ Step-by-Step Guide - Detailed manual verification steps

• Python 3.6 or higher
• Git repository
• Internet connection (for checking remote)

No additional dependencies required! Uses only Python standard library.

1. Download the script

gitclone https://github.com/Hajjouz/github-stats

2. Make it executable (optional)

chmod +x check.py

Simply run the script in your Git repository:

python3 check.py

======================================================================
   GITHUB CONTRIBUTIONS DIAGNOSTIC
======================================================================

1. EMAIL CONFIGURATION
----------------------------------------------------------------------
   Git email: [email protected]
   ✅ Email configured
   ⚠️  Must be VERIFIED at: https://github.com/settings/emails

2. BRANCH CHECK
----------------------------------------------------------------------
   Current branch: main
   Default branch: main
   ✅ On default branch (contributions will count)

3. RECENT COMMITS
----------------------------------------------------------------------
   a1b2c3d [email protected]         2024-10-05
   d4e5f6g [email protected]         2024-10-03
   ✅ Commits use configured email ([email protected])
   ⚠️  Email MUST be verified in GitHub!

4. REMOTE REPOSITORY
----------------------------------------------------------------------
   Remote URL: https://github.com/username/repo.git
   ✅ GitHub repository
   GitHub Profile: https://github.com/username
   ✅ Local and remote in sync (pushed)

5. COMMIT STATISTICS
----------------------------------------------------------------------
   Commits since 2024: 156
   Commits today: 3
   ✅ Repository has 156 commits

======================================================================
   VERIFICATION STATUS
======================================================================

📊 SCORE: 6/6 checks passed (100%)
──────────────────────────────────────────────────────────────────────
   [██████████████████████████████████████████████████] 100%

✅ PASSED CHECKS:
──────────────────────────────────────────────────────────────────────
   1. ✓ Email configured in git
   2. ✓ On default branch
   3. ✓ Commits use correct email
   4. ✓ Commits exist
   5. ✓ Repository is on GitHub
   6. ✓ Changes pushed to GitHub

======================================================================
   ✅ ALL AUTOMATED CHECKS PASSED!
======================================================================

   ╔════════════════════════════════════════════════════════╗
   ║  🎉 CONGRATULATIONS! All automated checks passed!      ║
   ╚════════════════════════════════════════════════════════╝

⚠️  MANUAL VERIFICATION REQUIRED:
──────────────────────────────────────────────────────────────────────

   📧 STEP 1: Verify Email
      • Your email: [email protected]
      • Visit: https://github.com/settings/emails
      • Ensure green checkmark ✓ next to your email

   🔒 STEP 2: Check Private Contributions (if private repo)
      • Visit: https://github.com/settings/profile
      • Find: 'Contributions & Activity'
      • Enable: ☑️ 'Include private contributions'

   ⏰ STEP 3: Wait for GitHub to Update
      • Contribution graph: 5-30 minutes
      • Total statistics: 24-48 HOURS ⚠️
      • Be patient! GitHub needs time to recalculate

======================================================================
   � MANUAL CHECKLIST
======================================================================

   ☑  Email configured in Git
   ☑  On default branch
   ☑  Changes pushed to GitHub
   ☐  Email VERIFIED in GitHub (manual check required!)
   ☐  'Include private contributions' ON (if private repo)
   ☐  Waited 24-48 hours for stats to update

======================================================================

╔════════════════════════════════════════════════════════════════╗
║                       💡 QUICK SUMMARY                         ║
╠════════════════════════════════════════════════════════════════╣
║  Status:    ✅ All automated checks PASSED                    ║
║  Action:    ⚠️  Verify email manually in GitHub               ║
║  Wait:      ⏰ 24-48 hours for stats to update                ║
║  Progress:  🟢 Ready for manual verification                 ║
╚════════════════════════════════════════════════════════════════╝

• Checks if Git email is configured
• Compares email in commits with configured email
• Critical: Email must match a verified email in GitHub

• Verifies you're on the default branch (main/master)
• Critical: Contributions only count on default branch
• Provides fix command if on wrong branch

• Lists last 5 commits with emails and dates
• Checks if commit emails match configured email
• Confirms commits exist in repository

• Verifies repository is on GitHub
• Extracts username from remote URL
• Checks if local commits are pushed to GitHub
• Provides direct links to GitHub settings

• Counts commits since last year
• Shows commits made today
• Helps verify repository activity

Problem:

❌ FAILED (1 check):
   ✗ Email not verified in GitHub

Solution:

1. Go to GitHub Email Settings
2. Find your email in the list
3. Click "Resend verification email" if no green checkmark
4. Check your inbox and verify the email
5. Wait 24-48 hours for GitHub stats to update

Problem:

❌ FAILED (1 check):
   ✗ Not on default branch

Solution:

# Switch to default branch
git checkout main

# Merge your changes
git merge your-branch-name

# Push to GitHub
git push origin main

Problem:

⚠️  Local ahead of remote - need to push!

Solution:

# Push your commits
git push

# Or if you need to set upstream
git push -u origin main

Problem:

⚠️  Some commits use different email!

Solution:

# Set correct email for future commits
git config --global user.email "[email protected]"

# For existing commits, they won't retroactively count
# Make new commits with correct email

Problem: Contributions show in graph but not in public stats.

Solution:

1. Go to GitHub Profile Settings
2. Scroll to "Contributions & Activity"
3. Check ☑️ "Include private contributions"
4. This makes private repo contributions visible on your profile

It's important to understand GitHub's update schedule:

⚠️ Most Important: Even if all checks pass, you may need to wait 24-48 hours for your total contribution count to update!

The tool provides a comprehensive scoring system with visual indicators:

📊 SCORE: 6/6 checks passed (100%)
──────────────────────────────────────────────────────────────────────
   [██████████████████████████████████████████████████] 100%

Visual Elements:

• Progress Bar - 50-character bar showing pass percentage (█ = passed, ░ = failed)
• Percentage Score - Exact percentage of passed checks
• Numbered Lists - Clear enumeration of passed and failed checks
• Visual Boxes - Professional bordered messages (╔═══╗ characters)
• Checkboxes - ☑ for completed items, ☐ for pending items
• Color Indicators - 🟢 (ready), 🟡 (needs attention), 🔴 (failed)

What Each Check Means:

• ✅ Email configured in git - Git knows your email
• ✅ On default branch - Commits will count
• ✅ Commits use correct email - Email consistency
• ✅ Commits exist - Repository has activity
• ✅ Repository is on GitHub - Not GitLab/Bitbucket
• ✅ Changes pushed to GitHub - Visible to GitHub

The tool uses professional formatting for easy reading:

[██████████████████████████████████████████████████] 100%
[███████████████████████████░░░░░░░░░░░░░░░░░░░░░░░] 60%
[████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░] 25%

╔════════════════════════════════════════════════════════╗
║  🎉 CONGRATULATIONS! All automated checks passed!      ║
╚════════════════════════════════════════════════════════╝

✅ PASSED CHECKS:
   1. ✓ Email configured in git
   2. ✓ On default branch
   3. ✓ Changes pushed to GitHub

☑  Email configured in Git
☑  On default branch
☐  Email VERIFIED in GitHub (manual check required!)
☐  Waited 24-48 hours for stats to update

╔════════════════════════════════════════════════════════════════╗
║                       💡 QUICK SUMMARY                         ║
╠════════════════════════════════════════════════════════════════╣
║  Status:    ✅ All automated checks PASSED                    ║
║  Action:    ⚠️  Verify email manually in GitHub               ║
║  Wait:      ⏰ 24-48 hours for stats to update                ║
║  Progress:  🟢 Ready for manual verification                 ║
╚════════════════════════════════════════════════════════════════╝

After running the tool, manually verify these items:

1. Visit: https://github.com/settings/emails
2. Locate your email in the list
3. Confirm it has a green checkmark ✓
4. If not, click "Resend verification email"

1. Visit: https://github.com/settings/profile
2. Scroll to "Contributions & Activity"
3. Enable: ☑️ "Include private contributions"

1. Graph updates: 5-30 minutes
2. Total stats: 24-48 hours
3. Be patient! GitHub needs time to recalculate

1. Visit your profile: https://github.com/YOUR_USERNAME
2. Click "Contribution activity" dropdown
3. Select different time periods
4. Verify contributions appear

# 1. Run diagnostic
python3 check.py

# Output shows you're not on main branch
# Score: 5/6 checks passed

# 2. Fix the issue
git checkout main
git push origin main

# 3. Run diagnostic again
python3 check.py

# Output shows all checks passed
# Score: 6/6 checks passed

# 4. Verify email in GitHub (manually)
# Visit: https://github.com/settings/emails

# 5. Wait 24-48 hours

# 6. Check your profile
# Visit: https://github.com/YOUR_USERNAME

If you're using backdated commits (common in automation scripts):

• ✅ Will show in contribution graph
• ✅ Will count in total stats (if all requirements met)
• ⚠️ But requires all checks to pass
• ⏰ Needs time to update (24-48 hours)

Contributions to forks only count if:

• Pull request is merged to the original repository
• Or you push directly to the fork's default branch

Contributions to organization repos:

• Always count regardless of privacy settings
• Show up immediately in graph
• May take time to update total stats

Possible Reasons:

1. Wait longer - Stats can take up to 48 hours
2. Cache - Try clearing browser cache or private/incognito mode
3. Email timing - If you just verified email, wait 24-48 hours
4. Multiple emails - Check if you have multiple GitHub accounts

Error: Not a git repository

Solution:

# Navigate to your git repository
cd /path/to/your/repository

# Then run the script
python3 check.py

Problem: Remote URL format not recognized.

Solution: The script handles these formats:

• https://github.com/username/repo.git
• [email protected]:username/repo.git

If yours is different, the script will still work but won't show username.

• Why are my contributions not showing up?
• About contribution graphs
• Verifying your email address

• GitHub Profile README Generator
• GitHub Stats
• Contribution Graph Action

Contributions are welcome! Here are some ways to improve this tool:

• Add more automated checks
• Support for other Git hosting services (GitLab, Bitbucket)
• Check for GitHub API rate limits
• Verify email directly via GitHub API
• Add color output for better readability
• Create web interface version

This tool is provided as-is for educational and troubleshooting purposes.

If you encounter issues:

1. Read the output carefully - The tool provides specific solutions
2. Check all manual items - Some things can't be automated
3. Wait 24-48 hours - Most common mistake is not waiting long enough
4. Verify email - 90% of issues are unverified emails
5. Check GitHub status - Visit GitHub Status

Based on common contribution issues:

This tool helps developers:

• ✅ Fix missing contribution streaks
• ✅ Ensure portfolio accuracy
• ✅ Troubleshoot backdate scripts
• ✅ Verify automation workflows
• ✅ Debug contribution gaps

1. Run this tool BEFORE creating lots of commits
2. Verify email FIRST - saves 24-48 hours of waiting
3. Always work on default branch for open source contributions
4. Enable private contributions if you work on private repos
5. Be patient - GitHub stats are not real-time

• GitHub Email Settings - Verify your email
• GitHub Profile Settings - Enable private contributions
• GitHub Status - Check if GitHub is down
• Git Config Guide - Set up Git correctly

Made with ❤️ for developers who want accurate contribution graphs!

Last Updated: October 2025

Version: 2.0.0 - Enhanced with professional visual formatting

A: Yes! If all checks pass and email is verified, backdated commits from any year will count in your stats.

A: Graph updates in 5-30 minutes. Total stats can take 24-48 hours.

A: Make sure you're checking the correct account. Email must be verified on the account you're pushing to.

A: Yes! Works on Windows, macOS, and Linux. Just need Python 3.6+.

A: Yes, as long as you have Git configured and can access the repository.

⭐ If this tool helped you, consider starring the repository!