Graph Greener Pro 🌳

Graph Greener Pro is a powerful Python CLI tool designed to simulate realistic GitHub contribution activity through backdated commits. It helps you fill your contribution graph with natural-looking activity patterns, mimicking human behavior while respecting your account's age.

Note

This tool is intended for personal and fun use only. It is designed to help you experiment with Git history and explore visualization patterns on your profile. We are not responsible for how you use this tool or any consequences resulting from its use. Use it responsibly!

Support the Project ⭐

If this tool helped you "green up" your profile, please give this repository a Star! It helps others find the project and keeps the development going.

Key Features ✨

• Human-Centric Distribution: Mimics real developer patterns with random gaps (vacations/breaks) and varied daily intensity (Light vs. Heavy days).
• Auto-Magic Config: Automatically detects your GitHub username from your local Git config and defaults to the last 1 year of history.
• Account Age Awareness: Integrates with the GitHub API to ensure that no commits are generated before your account was actually created, keeping your history realistic.
• Behavioral Personas: Choose between Student (weekend-heavy), Professional (9-to-5 weekdays), or Hardcore (constant activity) modes.
• Interactive Wizard: Simply run the script and follow the prompts, or use powerful CLI flags for automation.
• One-File Portability: A single, clean Python script containing 100+ realistic commit messages. No complex setup required.

Installation 🛠️

Ensure you have Python installed, then run:

pip install "typer[all]" rich requests

How to Use 🚀

Follow these steps for a perfect setup:

1. Create a Private Repo: Go to GitHub and create a new Private repository (e.g., named priv).
2. Clone it: Clone that repository to your local machine:

   git clone https://github.com/yourusername/priv.git
   cd priv

3. Drop the Script: Copy imp.py into this folder.
4. Run: Open your terminal in that folder and run:

   python imp.py

The script will guide you through the rest (Username, Start Date, Persona, etc.).

Advanced Commands

You can also use flags to customize the simulation:

# Simulate last 6 months as a hardcore developer
python imp.py --username your-user --start "6 months ago" --persona hardcore

# Preview the distribution without actual committing
python imp.py --dry-run

How It Works 🧠

Graph Greener Pro uses a sophisticated "Gap Engine" and intensity weights to ensure your graph doesn't just look like a solid wall of green. It introduces:

• Weekend Silence: (For professionals) High probability of 0 commits on weekends.
• Vacation Gaps: Occasional 2-10 day breaks to simulate time off.
• Commit Diversity: Uses 100+ different commit types (feat, fix, refactor, docs) to ensure your activity feed looks authentic.

License 📄

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