---
title: CC Smash
emoji: 💳
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: "5.9.0"
app_file: app.py
pinned: false
python_version: "3.11"
---

# 💳 CC Smash — Statement Analyzer

A Gradio app that ingests credit card statements (PDF, CSV, XLS/XLSX, DOCX)
and surfaces spending intelligence you'd never catch manually.

## Features

| Tab | What it does |
|---|---|
| 💰 Top 13 | Largest single purchases ranked by amount |
| 🔁 Recurring Charges | Monthly/weekly/quarterly charges with true annual cost |
| 📋 Possible Subscriptions | Small forgotten recurring charges |
| 📈 Year-over-Year | Spend changes across years (requires 2+ years) |
| 🔍 AI Insights | LLM-powered narrative analysis (BYOK) |

## Run locally

```bash
pip install -r requirements.txt
python app.py
```

## Deploy

Pushes to `main` are automatically synced to the HuggingFace Space via GitHub Actions.
Requires a `HF_TOKEN` secret in the GitHub repo settings with write access to `alm7640/CC_Smash`.

## Privacy

- Files are processed **entirely in memory** — never written to disk or any server
- Your API key lives only in your browser session and is discarded when you close the tab
- The AI Insights tab sends only **aggregated data** (merchant names + totals) to the LLM provider — no account numbers, card numbers, or personal details are ever sent

## Supported Banks

Any bank that exports PDF, CSV, or XLS is supported. Tested against Chase, Bank of America,
Citi, Capital One, American Express, Wells Fargo, and Discover.

## Data Quality Tiers

| Data | Features Unlocked |
|---|---|
| 1 statement | Top 13 only |
| 2–5 months | + Possible subscriptions |
| 6–11 months | + Recurring charges |
| 12 months | + True annual cost view |
| 24+ months | + Year-over-Year analysis |