🟢 GitHub Contribution Bot

📘 View Full User Guide

A browser-based, client-side app to simulate or automate GitHub activity via manual or scheduled commits — with heatmap preview, multi-repo support, and random or AI-powered commit messages.

---

🚀 Features

• ✅ Multi-repo commit support (with Smart Rotation)
• ✅ Auto or manual commits
• ✅ Smart commit messages (AI/random)
• ✅ GitHub contribution heatmap (live)
• ✅ PWA support (install as app)
• ✅ Simulated historic commit planner
• ✅ Token saved locally (client-side only)
• ✅ Commit Preview Modal (with on/off control)
• ✅ Usage Analytics Panel (Stats)

---

📦 Deploy Your Own (Free, One-Click via Vercel)

⚠️ IMPORTANT: Before deploying, click the Fork button (top right) to create your own copy of the repo.

🔹 1. Fork This Repo

Click the fork button on GitHub to make your own editable copy of this project.

🔹 2. Deploy via Vercel (One Click)

Make sure the template= URL points to your forked version, not the original.

Replace YOUR_USERNAME with your GitHub username after forking.

---

🔑 How to Generate Your GitHub Token

1. Go to: https://github.com/settings/tokens
2. Click "Generate new token (Classic)"
3. Give your token a descriptive name (e.g., "GitHub Bot Token").
4. Set an expiration date (e.g., 90 days or 1 year) or "No expiration" (use with caution).
5. Enable the following scopes:
   • ✅ repo (for creating/updating commits)
   • ✅ read:user (for fetching your real contribution heatmap)
6. Copy the token and paste it into the bot UI

ℹ️ Your token is stored only in your browser, never uploaded anywhere.

---

🧠 Tips for Usage

• Use random commit mode to simulate natural activity
• Enable Smart Rotation to distribute commits evenly across multiple repos for more stealth
• Track your performance with the live heatmap
• Install the bot as a Progressive Web App for offline use
• Use pattern generators or date presets for strategic activity planning
• Toggle Commit Preview to confirm or edit commits before they are made
• Check the Stats Panel for insights into your bot's activity and usage

---

🧰 Developer Setup (Optional)

# Clone your fork
git clone https://github.com/CryptoExplor/GitHub-Contribution-Bot
cd GitHub-Contribution-Bot

# Run locally (requires node or static server)
npx serve

---

📚 About This Project

This GitHub Auto Commit Bot is a side project built with ❤️ by FarmLabs. It's designed to help developers automate and visualize their GitHub contribution graph with style and intelligence.

✨ Why This Bot?

• To maintain streaks with ease (even across multiple repos)
• To simulate commit patterns without relying on CLI tools
• To give users full control over their contribution heatmap
• To provide transparency and control over automated actions with Commit Preview
• To offer insights into bot activity through the Stats Panel

🧠 Powered by Gemini AI

This tool uses the Gemini API to generate context-aware commit messages, making your activity logs more human-like and less repetitive.

---

🔗 Connect with the Developer

• Telegram – @dare_3

---

👥 Contributors

• 💻 Built and maintained by @CryptoExplor
• 🤝 PRs welcome! Fork, create a branch, and submit a pull request.

---

🙌 Support & Sponsorship

💸 Help support development and keep the commits flowing:

ETH / USDT / USDC (ERC-20)
0x1C46ccEA4D62d3eEC4DCE3501aa96d0Ff5FcA954

---

⚠️ Disclaimer

This project is for educational and demonstration purposes only. It is designed to show how GitHub Actions can be used for scheduled automation tasks — not for inflating contributions or misleading viewers.

Automating your GitHub activity can be a fun and informative way to learn about CI/CD, bots, scripting, and workflows — but it's important to use this responsibly:

• Be transparent in your usage
• Avoid spammy or misleading behavior
• Present it clearly as a testbed for learning automation

🧪 Built for learning, not for production.
💚 Happy green squares!

---

📄 License

MIT © 2025 CryptoExplor