Repository files navigation

A script that helps youinstantly generate a beautiful GitHub Contributions Graphfor the last year.

This script doesn't encourage you to cheat. Cheating is bad. But if anybody judges your professional skills bythe graph on your GitHub profile (which carries no value), they deserve to see a rich graph.

I created this project more than five years ago. Since then, I have built severalmuch more valuabletools which I encourage you to check:

• sol4k - Kotlin, JVM, and Android client for Solana
• podil.js - Lightweight and secure database schema migration tool
• goxygen - Web project generator
• zeit - A Fitbit clock face for learners of the German language

1. Create an empty GitHub repository. Do not initialize it.
2. Downloadthe contribute.py scriptand execute it passing the link on the created repository

python contribute.py --repository=git@github.com:<user-name>/<repo-name.git>

Make sure you enter your user-name and repo-name in command.

Now you have a repository with lots of changes in your GitHub account.Note: it takes several minutes for GitHub to reindex your activity.

The script initializes an empty git repository, creates a text file and startsgenerating changes to the file for every day within the last year (0-20 commitsper day). Once the commits are generated it links the created repository withthe remote repository and pushes the changes.

You might want to make the generated repository private. It is freeon GitHub. You only need to set up your accountto show private contributions.This way GitHub users will see that you contributed something, but they won't beable to see what exactly.

You can customize how often to commit and how many commits a day to make, etc.

For instance, with the following command, the script will make from 1 to 12commits a day. It will commit 60% days a year.

python contribute.py --max_commits=12 --frequency=60 --repository=git@github.com:user/repo.git

Use--no_weekends option if you don't want to commit on weekends

python contribute.py --no_weekends

If you do not set the--repository argument the script won't push the changes.This way you can import the generated repository yourself.

Use--days_before and--days_after to specify how many days before the currentdate the script should start committing, and how many days after the current date itwill keep committing.

python contribute.py --days_before=10 --days_after=15

Runpython contribute.py --help to get help.

To be able to execute the script you need to have Python and Git installed.

It might take several minutes for GitHub to reindex your activity. Checkif the repository has new commits and wait a couple of minutes.

Are you using a private repository? If so, enable showing private contributionsfollowing this guide.

Make sure the email address you have in GitHub is the same as you have inyour local settings. GitHub counts contributions only when they are madeusing the corresponding email.

Check your local email settings with:

git config --get user.email

If it doesn't match with the one from GitHub reset it with

git config --global user.email "user@example.com"

Create a new repository and rerun the script.

Maybe you tried to use an existing repository. If so, make sure you are usinga new one which isnot initialized.

If none of the options helped, open an issue and I will fix it as soon as possible.