A Telegram bot that tracks GitHub activity in real-time. Perfect for teams, group projects, and organizations to stay updated on commits, merges, and pull requests.
- 🔍 Track any GitHub username
- 📦 Detect repositories pushed after you start watching
- 📝 Get details like repo name, link, primary language & push time
- 🌿 See the branch name of recent commits
- 🔀 Detect and notify when branches are merged (with date & time)
- 📥 Stay informed on pull request activity
- ⏱️ Continuous monitoring with automatic updates
- 🛑 Start and stop tracking easily with bot commands
- Python 🐍 – Core logic
- python-telegram-bot 📲 – For Telegram Bot API
- Requests 🌐 – To fetch data from GitHub API
- GitHub REST API 🔧 – Source of all activity data
- Clone the repository:
git clone https://github.com/BikramMondal5/GitBot-Tracker.git- Navigate to the project directory:
cd GitBot-Tracker- Create and activate a virtual environment (optional but recommended):
python -m venv venv
source venv/bin/activate # On Mac/Linux
venv\Scripts\activate # On Windows- Install dependencies:
pip install -r requirements.txt- Create a
.envfile and add your tokens:
TELEGRAM_TOKEN=your_telegram_bot_token
GITHUB_TOKEN=your_github_personal_access_token- Run the bot:
python gitwatch_bot.pyGot ideas? or Found a bug? 🐞
- Open an issue or submit a pull request — contributions are always welcome!
This project is licensed under the MIT License.