README.md

---
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.