A Discord bot that sends notifications for GitHub events to your Discord server.
⚠️ WORK IN PROGRESS: This project is currently being refactored with improved design patterns and structure. It was initially started several years ago and is now being modernized. Features may change and documentation might be incomplete.
- 🔔 Real-time notifications: Get instant notifications for GitHub events in your Discord channels
- 📊 Issue tracking: Receive notifications for new issues, comments, and status changes
- 🔄 Pull request monitoring: Be notified of new PRs, reviews, and merges
- 🔗 Simple subscription system: Use Discord commands to subscribe to repositories
- 🛠️ Easy setup: Set up with just a few commands
- Invite the bot to your server
- Use
!subscribe owner/repoto start receiving notifications - That's it! You'll now receive notifications for new issues and PRs
Visit our GitHub Pages documentation for complete instructions on:
- Setting up the bot
- Available commands
- Self-hosting options
- Troubleshooting
See our installation guide for detailed instructions.
- Go 1.22 or higher
- A Discord Bot Token (Create a Discord Bot)
- A GitHub Personal Access Token (Create a GitHub Token)
# Clone the repository
git clone https://github.com/yourusername/github-notify.git
cd github-notify
# Configure environment
cp .env.example .env
# Edit .env with your tokens
# Build and run
go build -o github-notify ./cmd/main.go
./github-notifydocker run -d \
--name github-notify \
-p 8080:8080 \
-v /path/to/data:/app/data \
-e DISCORD_TOKEN=your_discord_bot_token \
-e GITHUB_TOKEN=your_github_personal_access_token \
yourusername/github-notify:latestContributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.