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.

---

Why this exists

• 🔒 100% local — bank data never leaves your machine/server
• 🏦 4 major banks, production-ready — HDFC, ICICI, SBI, Axis (covering ~70% of retail statements)
• 📊 Standardized output — same schema across all banks (date, description, debit, credit, balance, ref_no, category)
• ⚙️ Plugin architecture — add custom bank parsers in ~50 lines
• 🐳 Docker + PyPI — pip install or docker pull, runs anywhere
• 🧾 GST-ready — optional GSTR-2A reconciliation output
• 🤖 CI/CD friendly — GitHub Action template included

Quick start

Install

# pip (standard)
pip install indian-bank-statement-parser

# Poetry
poetry add indian-bank-statement-parser

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

# Docker (no Python needed)
docker pull ghcr.io/raptar231/indian-bank-statement-parser:latest

CLI

# Parse all PDFs in a directory
parse-bank-statements \
  --input-dir ./statements \
  --output-dir ./parsed \
  --bank hdfc \
  --format csv

# Parse single file
parse-bank-statements \
  --input-file ./statement.pdf \
  --output-file ./parsed.csv \
  --bank icici

# With GST reconciliation (GSTR-2A format)
parse-bank-statements \
  --input-dir ./statements \
  --output-dir ./parsed \
  --bank sbi \
  --reconcile-gstr2a \
  --gstin 29ABCDE1234F1Z5

# List supported banks
parse-bank-statements --list-banks

Python API

from bank_parser import parse_statements, parse_file, list_banks
import pandas as pd

# Parse all PDFs in directory
df = parse_statements(
    input_dir="./statements",
    bank="hdfc",
    output_format="dataframe"
)

# Parse single file
df = parse_file("./statement.pdf", bank="icici")

# With GST reconciliation
df = parse_statements(
    input_dir="./statements",
    bank="sbi",
    reconcile_gstr2a=True,
    gstin="29ABCDE1234F1Z5"
)

# Save to CSV
df.to_csv("parsed.csv", index=False)

# List supported banks
print(list_banks())
# ['hdfc', 'icici', 'sbi', 'axis']

---

Documentation

• Quickstart — Get running in 5 minutes
• Installation — Detailed install options
• Why not Bank CSV? — Comparison with bank CSVs
• CLI Reference — All commands and flags
• Python API — parse_statements, parse_file, models
• Supported Banks — HDFC, ICICI, SBI, Axis details
• Output Schema — Standardized columns
• GSTR-2A Reconciliation — GST workflow
• Adding a Bank Parser — Step-by-step guide
• Architecture — Internal design
• Testing — Test patterns
• Docker — Build, run, CI/CD
• GitHub Actions — CI/CD workflows
• PyPI Release — Release process

---

Supported banks

Bank	Status	Statement types
HDFC	✅ Production	Savings, Current, Credit Card
ICICI	✅ Production	Savings, Current, Credit Card
SBI	✅ Production	Savings, Current (all regional variants)
Axis	✅ Production	Savings, Current, Credit Card

Missing your bank? Add a parser in ~50 lines or request it.

---

License

Apache-2.0 — see LICENSE.

---

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

Report a bank format issue • Request a feature • Request a bank