https://github.com/row-huh/goldfish

Track your finances
https://github.com/row-huh/goldfish

python streamlit

Last synced: 5 months ago
JSON representation

Track your finances

• Host: GitHub
• URL: https://github.com/row-huh/goldfish
• Owner: row-huh
• Created: 2025-05-28T17:31:35.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-08-07T11:52:41.000Z (11 months ago)
• Last Synced: 2025-08-07T13:12:19.373Z (11 months ago)
• Topics: python, streamlit
• Language: Python
• Homepage:
• Size: 713 KB
• Stars: 0
• Watchers: 0
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# GoldFish

### Track your finance

A modern, visually stunning expense tracker built with Streamlit. Effortlessly log, import, and visualize your spending with multi-currency support, OCR-powered receipt scanning, and beautiful charts.

![Landing Page](md-assets/landing-page.png)

## Features

- **Add Expenses:**  

  Quickly log daily expenses with multi-currency support and smart categorization.

- **Import Bank CSV:**  

  Bulk import transactions from your bank statements. Preview and import with a single click.

- **Receipt Scanning (OCR):**  

  Upload a photo of your receipt and let AI extract line items automatically.

- **Spending Summary:**  

  Interactive pie and bar charts to visualize your spending patterns.

- **View Expenses:**  

  Browse, filter, and analyze all your transactions in a clean, stylish table.

![View Your Expenses](md-assets/image.png)

## 🛠️ Getting Started

1. **Clone the repo:**

   ```sh

   git clone https://github.com/yourusername/expense-tracker.git

   cd expense-tracker

2. **Install dependencies:**

   ```sh

   pip install -r requirements.txt

3. Set up your google api key

  add your key to a .env file

  ```sh

    GOOGLE_API_KEY="your-google-api-key"

  ```

4. Run the app:

```python

streamlit run main.py