Skip to content

RozhakDev/LovelyPlnAssistant

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Lovely PLN Assistant

Bot pengingat sederhana untuk membantu mengingatkan swacam PLN (self-meter) setiap tanggal 24–25 jam 08:00 WIB melalui Telegram.

Dibuat agar pemiliknya gak lupa kirim foto meteran dan terhindar dari tagihan estimasi. Sekalian jadi pengingat manis tiap pagi untuk orang yang disayang 🙂

Fitur

  • Dibangun dengan Python + Poetry, struktur rapi untuk dikembangkan.
  • Tanpa server, berjalan sepenuhnya di GitHub Actions.
  • Pengingat harian otomatis pada tanggal 23, 24, dan 25.
  • Menggunakan Telegram Bot API (HTTP request sederhana).

Struktur Proyek

LovelyPlnAssistant/
├── src/
│   └── lovelyplnassistant/
│       ├── main.py
│       └── messages.py
├── scripts/
│   └── send_reminder.py
└── .github/
    └── workflows/
        └── reminder.yml

Cara Menjalankan

  1. Install dependencies:

    poetry install
  2. Set environment variable (opsional untuk uji lokal):

    export BOT_TOKEN="your_token"
    export CHAT_ID="your_chat_id"
  3. Tes lokal:

    poetry run python scripts/send_reminder.py
  4. Tambahkan GitHub Secrets:

    • BOT_TOKEN
    • CHAT_ID

Setelah itu workflow akan berjalan otomatis setiap bulan.

Lisensi

Proyek ini dirilis menggunakan MIT License.

Catatan

Bot ini awalnya dibuat untuk seseorang yang sering lupa swacam, dan biar ada “pesan manis jam 8 pagi” yang bikin hari lebih ringan 🙂💗

About

Simple Telegram bot that sends monthly PLN self-meter reminders (23–25). Automated via GitHub Actions, written in Python & Poetry.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages