indian-bank-statement-parser

Offline-first CLI & Python library to convert Indian bank statement PDFs (HDFC, ICICI, SBI, Axis) into standardized CSV/JSON for GST reconciliation, accounting, and lending workflows.

Quick Start

# pip
pip install indian-bank-statement-parser

# Poetry
poetry add indian-bank-statement-parser

# UV (fast)
uv add indian-bank-statement-parser

# Docker
docker pull ghcr.io/raptar231/indian-bank-statement-parser:latest

# Parse directory
parse-bank-statements --input-dir ./statements --output-dir ./parsed --bank hdfc

# Parse single file
parse-bank-statements --input-file ./stmt.pdf --output-file ./out.csv --bank icici

# GSTR-2A reconciliation
parse-bank-statements --input-dir ./stmts --output-dir ./gstr2a --bank sbi --reconcile-gstr2a --gstin 29ABCDE1234F1Z5

Why this exists

Use this if: You process 10+ statements/month, need GST reconciliation, multi-bank standardization, or full history.

Skip if: Occasional personal statements — bank CSV is fine.

Documentation

Full docs: raptar231.github.io/indian-bank-statement-parser

• Quickstart
• CLI Reference
• Python API
• Supported Banks
• GSTR-2A Reconciliation
• Adding a Bank
• Docker
• PyPI Release

Supported Banks

Don't see your bank or statement format?

Open an issue or drop an email with details so support can be added:

• 🐛 Report an unsupported document: Open an issue and attach an anonymized sample PDF/CSV
• 🏦 Request a new bank: Open an issue with the bank name, statement type (savings/current/credit card), and an anonymized sample
• 📧 Email: mondalsonu4@gmail.com

Please make sure to anonymize your statement (mask account numbers, names, and amounts) before sharing.

Install & Run

# Development
git clone https://github.com/raptar231/indian-bank-statement-parser
cd indian-bank-statement-parser
pip install -e ".[dev]"

# Tests
pytest tests/ -v

# Code quality
ruff check bank_parser/ tests/
mypy bank_parser/
black --check bank_parser/ tests/

License

Apache-2.0 — see LICENSE.

Support

If this tool saves you time, consider supporting development:

• ☕ Buy Me a Coffee: buymeacoffee.com/raptar231
• ❤️ GitHub Sponsors: github.com/sponsors/raptar231
• 📧 Contact: mondalsonu4@gmail.com

Built for CA firms, lenders, and fintechs processing Indian bank statements at scale.