Telegram GitHub Issue Bot

Telegram bot written in Go that monitors a GitHub issues feed and notifies users about new issues matching their personal filters.

Special thanks to iedr/goodfirstissues for the issue data source.

Features

• Personalized Filters:

• Filter by Repository Language (e.g., Go, Rust, TypeScript).

• Filter by Minimum Stars.

• Filter by Labels (e.g., "good first issue", "bug").

Project Structure

cmd/
  bot/          # Main entry point
internal/
  bot/          # Telegram bot handlers and logic
  config/       # Configuration loading
  github/       # GitHub API client (fetching issues)
  logger/       # Structured logging
  models/       # Domain models
  service/      # Core business logic (polling, matching)
  storage/      # Database layer (SQLite)

Setup & Running

• Prerequisites:

• Go 1.21+

• GCC (for SQLite CGO)

• Configuration:

cp .env.example .env

• TELEGRAM_TOKEN: Your Bot Token from @BotFather.

• Build and Run:

go mod tidy
   go build -o bot ./cmd/bot
   ./bot

• Usage:

• Start a chat with the bot on Telegram.

• Use the menu buttons to configure your filters.

• Wait for notifications!

Development

• Run tests:

go test ./...