Skip to content

Quickstart

Get running in 5 minutes.

Prerequisites

  • Python 3.10+
  • PDF statements from HDFC, ICICI, SBI, or Axis Bank

Install

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

# Poetry
poetry add indian-bank-statement-parser

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

Parse your first statement

CLI

# Parse single PDF
parse-bank-statements \
  --input-file ./hdfc_statement.pdf \
  --output-file ./parsed.csv \
  --bank hdfc

# Parse directory of PDFs
parse-bank-statements \
  --input-dir ./statements \
  --output-dir ./parsed \
  --bank icici \
  --format csv

Python

from bank_parser import parse_file

df = parse_file("./statement.pdf", bank="hdfc")
df.to_csv("parsed.csv", index=False)
print(df.head())

Output

date,description,debit,credit,balance,ref_no,category
2024-01-15,"UPI-PAYMENT TO MERCHANT",500.00,,45000.00,UPI123456789,debit
2024-01-16,"SALARY CREDIT",,120000.00,165000.00,SAL987654321,credit

Next steps