🤖 Auto Contribution Bot

Status: ● LIVE & WORKING
Maintained by: Naboraj Sarkar (Nishant)
Category: GitHub Automation • Dev Tools • Productivity
Vibe: 🎮 Gaming × 💻 Code × 🤖 Automation × 💙 Blue Energy

---

🔥 What This Bot Does

Auto Contribution Bot is a lightweight GitHub Actions-powered tool that automatically creates one safe, natural-looking contribution every day to keep your GitHub graph green and your streak alive. Perfect for busy devs and gamers who want consistency without the grind.

• ✅ Runs daily on autopilot
• 🎲 Random delay (0–2 hours) for a human-like touch
• 🟢 Builds real green squares (using your email)
• ⚙️ Zero ongoing effort after setup
• 🔐 Uses built-in GITHUB_TOKEN—no extra tokens needed

---

🧠 How It Works (Technical Breakdown)

1. GitHub Actions schedules a daily trigger (07:00 UTC ≈ 12:30 PM IST).
2. Repo is checked out securely.
3. Applies a random delay to avoid patterns.
4. Appends a timestamped line to log.txt (in IST timezone).
5. Commits and pushes using your details for authentic contributions.

The limited delay ensures no skips, and it only commits if there's a real change—bulletproof and efficient.

---

📁 Project Structure

.github/
 └── workflows/
     └── daily.yml (the magic automation file)
log.txt (daily updated log file)
README.md (this file)

---

🚀 Quick Setup Guide

1️⃣ Create a New Repo

• Make it public or private (both work for contributions).
• Use main as the default branch.

2️⃣ Add the Workflow File

Create .github/workflows/daily.yml and paste this:

name: Daily Contribution

permissions:
  contents: write

on:
  schedule:
    - cron: '0 7 * * *'  # 07:00 UTC ≈ 12:30 PM IST
  workflow_dispatch:

jobs:
  auto-contribute:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Random delay (0–2 hours, more natural)
        run: sleep $((RANDOM % 7200 + 300))  # min 5 min delay

      - name: Make daily commit (IST timezone)
        run: |
          export TZ=Asia/Kolkata

          # Safety: create file if missing
          touch log.txt

          # Append fresh line with timestamp
          echo "Daily auto update: $(date '+%Y-%m-%d %H:%M:%S %Z')" >> log.txt

          git config user.name "NABORAJ SARKAR"
          git config user.email "nishant.ns.business@gmail.com"

          git add log.txt

          # Commit only if changes exist
          git diff --staged --quiet || git commit -m "chore: daily contribution $(date '+%Y-%m-%d')"

          git push origin HEAD

3️⃣ Commit and Push

Push the file to main. Boom—the bot's live!

Pro Tip: Verify your email (nishant.ns.business@gmail.com) is added in GitHub Settings > Emails. For private repos, enable "Include private contributions" in your profile settings.

---

🧪 Testing It Out

• Head to your repo's Actions tab.
• Select Daily Contribution.
• Click Run workflow (manual trigger).
• Watch the logs—success means a new commit and green square in 5–30 mins.

---

⏰ Timing Details

• Trigger: 07:00 UTC (≈ 12:30 PM IST).
• Actual Commit: Random within 0–2 hours after.
• Why IST? Tailored for devs in India like us in Siliguri—keeps it daytime fresh.

---

⚠️ Warnings & Ethics

• This is for genuine consistency, not faking skills.
• Stick to one commit/day—don't spam or loop.
• Over-automation can flag as unnatural; keep it subtle.
• Real code > green squares. Use this to build habits, not hype.

Automation rocks, but pair it with actual projects for that true gamer-dev win.

---

🎮 Gaming × Developer Vibe

Built by a Siliguri-based Hindu Bengali dev who loves blue vibes 💙. I believe in:

• ⚡ Systems that level up your grind.
• 🎯 Automation to free up time for gaming and coding.
• 🧠 Consistency as the ultimate power-up.

---

🌐 About Me & Socials

Naboraj Sarkar (Nishant)
Student • Developer • Gamer • Content Creator from Siliguri, West Bengal, India.

• 🌐 Website: nsgamming.xyz
• 🐙 GitHub: NABORAJ'S
• ▶️ YouTube: NS GAMMiNG
• 📸 Instagram: @NABORAJ SARKAR
• 🐦 X (Twitter): @NSGAMMING699
• 💬 Telegram: @nsgamming69
• 💼 LinkedIn: Naboraj Sarkar

---

🔍 SEO Keywords

GitHub automation, auto contribution bot, GitHub Actions daily commit, developer productivity tools, coding streak maintainer, natural GitHub contributions, automation for devs, GitHub portfolio booster, NS GAMMiNG projects, Naboraj Sarkar developer, Nishant Sarkar GitHub.