Design and upload a unique Github contribution graph that makes your Github profile stand out.
- Interactive Web App: Simple Streamlit interface allows you to generate unique patterns
- GitHub Integration: Automatically upload commit designs to your repository
- Profile enhancement: Improve visual appeal and have fun with your Github profile
- Python 3.12 or higher
- A GitHub account and personal access token
- A new GitHub repository for uploading commits
You'll need a GitHub Personal Access Token with repo permissions. Create one at GitHub Settings > Developer settings > Personal access tokens.
-
Clone the repository:
git clone https://github.com/your-username/github-contribution-graph-editor.git cd github-contribution-graph-editor -
Install dependencies:
pip install -e .Or using uv (recommended):
uv sync
Create a .streamlit/secrets.toml file in the project root:
GITHUB_USERNAME = "your-github-username"
GITHUB_EMAIL = "your-email@example.com"
GITHUB_TOKEN = "your-personal-access-token"
REPO_URL = "https://github.com/your-username/your-repo.git"Run the Streamlit app for an interactive experience:
streamlit run src/app.pyThis will open a web interface available at http://localhost:8501 where you can:
- Manually edit the contribution grid (7x52 cells representing days)
- Use "Random Fill" to generate random patterns
- Preview the contribution graph
- Upload commits to GitHub
Contributions of any kind welcome. See contributing guide.
This project is licensed under the MIT License - see the LICENSE file for details.
This tool creates commits on your GitHub repository. Use responsibly and be aware that excessive automated commits may violate GitHub's terms of service. The commits created are empty (no actual code changes) and serve only to visualize patterns on your contribution graph.