Metadata-Version: 2.4
Name: bank-statement-parser-v1
Version: 0.1.0
Summary: Parse Indian bank PDF statements (HDFC, SBI, Yes Bank, RBL, IndusInd, One, Standard Chartered) into structured transaction data.
License: MIT
Project-URL: Homepage, https://github.com/birr/bank-statement-parser
Project-URL: Issues, https://github.com/birr/bank-statement-parser/issues
Keywords: bank,statement,pdf,parser,india,transactions
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Text Processing :: Filters
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: pdfplumber>=0.10.0
Requires-Dist: pandas>=1.5.0
Provides-Extra: excel
Requires-Dist: openpyxl>=3.1.0; extra == "excel"
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"

# Bank Statement Parser

A web application that parses Indian bank statement PDFs into structured Excel sheets.

## Deploy to Render (One Click)

[![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy?repo=https://github.com/atul0016/bank-statement-parser)

## Supported Banks
- **SBI** Bank & Credit Card
- **HDFC** Bank & Credit Card
- **Yes Bank** & Credit Card
- **IndusInd** Credit Card
- **RBL** Bank & Credit Card
- **Standard Chartered** Bank
- **One Card** Credit Card

## Features
- Upload PDF bank statements (with optional password for protected files)
- Auto-detects bank type using IFSC codes and keywords
- Extracts all transactions with: Serial Number, Date, Description, Debit, Credit, Running Balance, Ledger
- Download parsed data as styled Excel (.xlsx) files
- Smart ledger categorization (Transfer, Food & Dining, Utilities, etc.)

## Quick Start

```bash
# Clone the repo
git clone https://github.com/YOUR_USERNAME/bank-statement-parser.git
cd bank-statement-parser

# Create virtual environment
python -m venv .venv
.venv\Scripts\activate  # Windows
# source .venv/bin/activate  # Linux/Mac

# Install dependencies
pip install -r requirements.txt

# Run the app
python app.py
```

Then open http://127.0.0.1:5000 in your browser.

## How It Works
1. Upload a bank statement PDF
2. The app auto-detects the bank type
3. Transactions are extracted and displayed in a table
4. Click "Download Excel" to get a styled spreadsheet

## Tech Stack
- **Backend:** Python, Flask, pdfplumber
- **Frontend:** HTML/CSS/JavaScript
- **Excel Export:** openpyxl
