test

Kalau kamu sering lupa catat pengeluaran, bot ini bisa jadi solusi sederhana yang langsung kepakai. Kamu cukup kirim chat di Telegram seperti makan 35rb, lalu data langsung tersimpan.

Di tutorial ini, kita setup dari nol sampai bot siap dipakai harian.

Step 1 — Clone project

Ambil source code ke komputer kamu:

git clone https://github.com/derwinmhrdka/bot-financial-tracker.git
cd bot-financial-tracker

Step 2 — Buat file env

Copy template env:

copy deploy\env.local.example .env.local

Isi file .env.local seperti contoh aman berikut:

TELEGRAM_BOT_TOKEN=ISI_TOKEN_BOT_KAMU
TELEGRAM_ALLOWED_USERS=123456789
TELEGRAM_ADMIN_USERS=123456789
FINTRACKER_DB_PATH=./data/expenses.db
GOOGLE_SHEETS_ENABLED=false
GOOGLE_SHEETS_SPREADSHEET_ID=
GOOGLE_SERVICE_ACCOUNT_FILE=./secrets/google-service-account.json
GOOGLE_SHEETS_WORKSHEET=DETAIL
GOOGLE_SHEETS_LAYOUT=detail
GOOGLE_SHEETS_CATEGORY_DEFAULT=Daily
GOOGLE_SHEETS_BUDGET_RANGE=A2:E25

Catatan: jangan publish token bot, ID asli, atau credential JSON di postingan publik.

Step 3 — Install dependency

pip install -r requirements.txt

Step 4 — Jalankan bot

.\scripts\start-telegram-bot.ps1

Step 5 — Tes dari Telegram

Kirim chat berikut:

makan 35rb
sisa daily
total bulan ini
list 10

Contoh query natural language

Sudah berapa kali bensin?
Sudah berapa infaq bulan ini?
Daily lebih dari 200k

Aturan bulan (simple)

makan 35rb → bulan berjalan
jajan 10k April → masuk April
sisa juni → baca budget tab JUNE

Opsional: Google Sheets

Kalau mau sinkron ke spreadsheet, aktifkan GOOGLE_SHEETS_ENABLED=true lalu isi spreadsheet ID dan service account file. Untuk tab budget gunakan nama bulan Inggris: JANUARY, MAY, JUNE, dan seterusnya.

Penutup

Selesai. Dengan setup ini, kamu sudah punya bot financial tracker yang ringan, cepat, dan enak dipakai langsung dari Telegram.