financemanager / README.md
spacedout-bits's picture
Rebuild: finance manager chat assistant with HF CSV storage and Telegram bot
2a7171f

A newer version of the Gradio SDK is available: 6.14.0

Upgrade
metadata
title: Finance Manager
emoji: ๐Ÿ’ธ
colorFrom: green
colorTo: blue
sdk: gradio
sdk_version: 6.5.1
app_file: app.py
pinned: false
hf_oauth: true
hf_oauth_scopes:
  - inference-api

๐Ÿ’ธ Finance Manager

A personal finance assistant with natural language expense logging, persistent CSV storage on HuggingFace Hub, and a Telegram bot interface.

Features

  • Chat UI โ€” describe expenses in plain English; the AI parses and logs them
  • Ledger tab โ€” view all entries, refresh on demand
  • Telegram bot โ€” same assistant available in Telegram
  • Persistent storage โ€” ledger CSV synced to a private HF dataset repo

Required Secrets (Space Settings โ†’ Repository secrets)

Secret Purpose
HF_TOKEN Token with write access to your ledger dataset repo
HF_LEDGER_REPO Dataset repo ID for CSV storage, e.g. username/finance-ledger
TELEGRAM_BOT_TOKEN Optional โ€” Telegram bot token from @BotFather

Without HF_TOKEN + HF_LEDGER_REPO, entries are saved to /tmp and will not survive a Space restart.