Skip to content

farhan-hamzah/FinPal

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ’° FinBot - Telegram Keuangan Pribadi

FinBot adalah bot Telegram berbasis Python yang membantu kamu mencatat, menganalisis, dan mengelola keuangan harian secara otomatis β€” langsung melalui Telegram.


πŸš€ Fitur Utama

βœ… Catat pemasukan dan pengeluaran dengan mudah
βœ… Tampilkan total pemasukan/pengeluaran per rentang tanggal
βœ… Visualisasi grafik pemasukan & pengeluaran (line chart)
βœ… Fitur hapus data yang salah
βœ… Interaksi berbasis tombol (inline buttons)
βœ… Semua data disimpan dalam CSV lokal
βœ… Desain modular dan siap di-deploy ke cloud seperti Render


πŸ“Έ Tampilan Bot

πŸ‘‡ Menu Utama:

  1. Pengeluaran hari ini
  2. Pemasukan hari ini
  3. Cek pengeluaran bulan ini
  4. Cek pemasukan bulan ini
  5. Cek grafik pengeluaran bulan ini
  6. Cek grafik pemasukan bulan ini
  7. Menghapus data yang salah
  8. Keluar

πŸ—οΈ Struktur File

. β”œβ”€β”€ main.py # Script utama bot β”œβ”€β”€ requirements.txt # Daftar library yang dibutuhkan β”œβ”€β”€ pengeluaran.csv # File log pengeluaran user β”œβ”€β”€ pemasukan.csv # File log pemasukan user β”œβ”€β”€ log_interaksi.csv # Log menu yang diklik user └── .render.yaml # (opsional) config untuk auto-deploy ke Render


πŸ§ͺ Format Input User

πŸ“₯ Contoh Input Pemasukan: Tanggal: 16-07-2025 Uang masuk: 50000

πŸ“€ Contoh Input Pengeluaran: Tanggal: 16-07-2025 Uang keluar: 25000

πŸ“Š Contoh cek laporan/grafik: Tanggal awal: 01-07-2025 Tanggal akhir: 15-07-2025

πŸ—‘ Contoh hapus data: Jenis: pengeluaran Tanggal: 16-07-2025


πŸ–ΌοΈ Contoh Grafik

  • Grafik pengeluaran/pemasukan dikirim sebagai gambar ke chat Telegram
  • Menggunakan matplotlib + io.BytesIO

πŸ”§ Cara Menjalankan Bot

  1. Install Dependency pip install -r requirements.txt

  2. Jalankan bot: python main.py

☁️ Deploy ke Render (Gratis)

Upload project ini ke GitHub Buat akun di Render.com Buat Web Service baru dari repo ini Isi Start Command: python main.py Tambahkan Environment Variable: -TELEGRAM_TOKEN=your_token_here Done πŸŽ‰

🧩 Dependencies pyTelegramBotAPI (Telebot) pandas matplotlib

πŸ“ƒ Lisensi Proyek ini open-source dan bebas digunakan untuk pembelajaran dan pengembangan pribadi.

πŸ€– Dibuat oleh Farhan Hamzah – @farhan-hamzah Ingin dukung? Cukup pakai & kembangkan bot ini ✨

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages