Know Your Contributions. Measure Your Impact.

Code is intellectual property and should be treated as such. Know your contributions and value added.

GitPulse is a powerful tool for analyzing Git repositories, providing insights into contributor statistics, language usage, and more. It works with both local Git repositories and remote GitHub repositories.

✅ Commit Counts – See how many commits each contributor has made.
✅ Pull Request Insights – Track PRs opened and merged per user.
✅ Language Contributions – Understand which languages each contributor has worked on.
✅ Lines of Code Analysis – Identify meaningful code contributions per user.
✅ Issue Tracking – View issues opened and closed per contributor.
✅ Percentage Contribution – Measure the overall contribution of each developer to the codebase.
✅ Top Languages – Discover the dominant languages in a repository.
✅ Contributor Analysis: See who contributed the most to a repository
✅ Contribution Percentages: View each contributor's percentage of total changes
✅ Language Statistics: Analyze which programming languages are used in the repository
✅ GitHub Integration: Analyze remote GitHub repositories using the GitHub API

GitPulse can be used as:

• A CLI tool for quick repo analysis.
• A Web App for visualizing and comparing contributions across repositories.

🔹 CLI: Install and run GitPulse to analyze a local or GitHub repository.
🔹 Web App: Upload or link a repo to get instant contribution insights.

Your code tells a story. Let GitPulse help you understand it.

Andile Jaden Mbele
🚀 Software Engineer | Data Engineer | AI Enthusiast
📌 CEO @ Vectra Dynamics
💡 Passionate about building technology that empowers people

🌍 Follow my work

• GitHub: @xeroxzen
• Twitter: @andilejaden
• LinkedIn: Andile Jaden Mbele

# Clone the repository
git clone https://github.com/xeroxzen/GitPulse.git
cd GitPulse

# Install dependencies
pip install -r requirements.txt

# Set up GitHub token (for remote repository analysis)
echo "GITHUB_TOKEN=your_github_token" > .env

GitPulse provides a simple command-line interface for analyzing repositories:

# Analyze a local repository
./test_contributions.py --local /path/to/local/repo

# Analyze a remote GitHub repository
./test_contributions.py --remote https://github.com/xeroxzen/GitPulse.git

# Analyze the current directory (must be a Git repository)
./test_contributions.py

You can also use GitPulse as a library in your Python code:

from gitpulse.core.repository import Repository

# Analyze a local repository
local_repo = Repository("/path/to/local/repo", is_remote=False)
local_repo.display_contribution_stats()
local_repo.display_language_stats()

# Analyze a remote GitHub repository
github_repo = Repository("https://github.com/xeroxzen/GitPulse.git", is_remote=True)
github_repo.display_contribution_stats()
github_repo.display_language_stats()

# Get raw data for custom analysis
contributors = github_repo.get_contributor_stats()
languages = github_repo.get_top_languages()
percentages = github_repo.get_contribution_percentages()

For analyzing remote GitHub repositories, you need to authenticate with the GitHub API:

1. Create a GitHub Personal Access Token:

   • Go to GitHub.com → Settings → Developer Settings → Personal Access Tokens → Tokens (classic)
   • Click "Generate new token (classic)"
   • Give it a name and select the necessary scopes (at minimum, you'll need repo access)
   • Copy the generated token

2. Set the token in your environment:

   • Create a .env file in the project root with: GITHUB_TOKEN=your_token_here
   • Or set it as an environment variable: export GITHUB_TOKEN=your_token_here

You can build and run GitPulse using Docker:

# Build the image
docker build -t gitpulse .

# Run the container
docker run -p 8000:8000 gitpulse

The API will be available at http://localhost:8000.

                       Repository Contribution Statistics
┏━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ Contributor ┃ Commits ┃ Lines Added ┃ Lines Deleted ┃ Files Changed ┃ Total Changes ┃ Percentage ┃
┡━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ user1       │     42 │       2500 │         500 │          120 │         3000 │     75.0% │
│ user2       │     15 │        800 │         200 │           50 │         1000 │     25.0% │
└─────────────┴────────┴────────────┴─────────────┴──────────────┴──────────────┴───────────┘

                    Repository Language Statistics
┏━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━┓
┃ Language ┃ Lines of Code ┃ Percentage ┃
┡━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━┩
│ Python   │        10000 │      80.0% │
│ HTML     │         1500 │      12.0% │
│ CSS      │          500 │       4.0% │
│ JavaScript │          500 │       4.0% │
└──────────┴──────────────┴────────────┘

Contributions are welcome! Please feel free to submit a Pull Request.

This project is licensed under the MIT License - see the LICENSE file for details.