File size: 1,069 Bytes
e63cc01
2a7171f
 
 
 
e63cc01
 
 
 
 
 
 
 
 
2a7171f
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
---
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.