GitCanvas is a powerful Streamlit application that transforms your GitHub contribution history into stunning visual art. Say goodbye to boring green squares... visualize your coding journey with style, create your own themes, and make you GitHub truly personal!
Transform your GitHub stats with our diverse theme library:
-
🌌 Space: Contributions become twinkling stars in the cosmos
-
🦸 Marvel: Comic-book style with glowing Infinity Stones
-
🤖 Matrix: Digital rain cascading based on contribution intensity
-
🏏 Cricket: Stadium theme with runs scored from your commits
-
👾 Pac-Man: Arcade maze with pellets and power-ups
-
🌃 Cyberpunk: Neon-lit futuristic grid with glowing blocks
-
🦑 Squid Game: Inspired by the popular series
-
👻 Stranger Things: Upside Down theme with Demogorgon
-
🎨 Retro: Vintage typewriter style on aged paper
and more..... (with all your new contributions!!!)
| Card Type | What It Shows |
|---|---|
| Main Stats | Total stars, commits, repos, followers |
| Top Languages | Your most-used programming languages |
| Top Repositories | Showcase your best projects |
| Contribution Graph | Heatmap with customizable date ranges |
| GitHub Streak 🔥 | Track your contribution streaks |
| Trophy Card 🏆 | Achievement badges and milestones |
| Recent Activity 📱 | Latest GitHub events and interactions |
| Social Links 🔗 | Connect all your profiles |
| Icons & Badges 🎯 | Tech stack visualization |
| Feature | Description |
|---|---|
| AI Roast 🔥 | Get humorous AI-generated roasts of your GitHub profile |
| AI Description ✍️ | Generate a theme-aware summary of your GitHub stats from the app |
| AI Providers | Supports OpenAI and Google Gemini |
| Description Tones | Choose professional, funny, or creative tone |
| Option | Description |
|---|---|
| Custom Theme Creator | Build and save your own color schemes |
| Color Customization | Override any theme's colors on the fly |
| Animations | Enable/disable SVG animations |
| Date Range Filtering | View contributions for specific time periods |
| Export Formats | Markdown and HTML code generation |
| Export Type | Description |
|---|---|
| SVG Download | Vector graphics for any resolution |
| PNG/JPEG Download | Raster images via browser canvas |
| Markdown Code | Embed cards directly in GitHub README |
| HTML Code | Use in websites and blogs |
| API Endpoints | FastAPI backend for programmatic access |
# Clone the repository
git clone https://github.com/devanshi14malhotra/GitCanvas.git
cd GitCanvas
# Install dependencies
pip install -r requirements.txt
# Run the app
streamlit run app.pyThe app will open at http://localhost:8501 ... or you can just use the live deployed application!
Optional: Add a .env file with your GITHUB_TOKEN for higher API rate limits (5,000/hour vs 60/hour)
- Enter any GitHub username
- Select a theme from 15+ options
- Customize colors and enable animations
- Navigate through different card types
- Download as SVG/PNG or copy embed code
We're actively accepting contributions! We especially welcome:
🎨 New Themes - Create unique visualizations for contribution graphs
🐛 Bug Fixes - Help improve stability and performance
✨ New Features - Stats cards, export options, UI enhancements
📚 Documentation - Tutorials, examples, and guides
- Fork this repository to your GitHub account (required before sending a PR)
- Clone your fork and create a feature branch
- Push your branch to your fork
- Open a Pull Request from your fork to
devanshi14malhotra/GitCanvas - Make your changes (always use real GitHub data, never fake contributions)
- Test thoroughly with actual GitHub usernames
- Submit a Pull Request with clear description (screenshots and/or screen recordings of themes preferred)
If you like this project, please consider giving the repository a star. It is greatly appreciated and helps the project reach more contributors.
- CONTRIBUTING.md - Complete contributor guide with setup instructions and theme creation
- API Docs - FastAPI auto-generated documentation at
/docsendpoint
Found a bug or have a feature idea? Open an issue - we'd love to hear from you!
This project is licensed under the MIT License
- Live Demo: gitcanvas-dm.streamlit.app
- GitHub Repository: devanshi14malhotra/GitCanvas
- Issues & Feature Requests: GitHub Issues
If you like this project, please consider giving the repository a ⭐ STAR ⭐.Made by Devanshi Malhotra and contributors
Turn your code into art! 🎨✨