nkscoder-indian-banks 1.0.1

Indian bank logos and structured metadata by Nitesh Kumar Singh (nkscoder) — IFSC prefixes, USSD codes, websites, and RBI bank types.

indian-banks

Author: Nitesh Kumar Singh · GitHub: @nkscoder
Repository: github.com/nkscoder/indian-banks

Open-source Indian bank logos & structured data — IFSC prefixes, USSD balance codes, websites, and RBI bank categories for fintech apps, UPI flows, and banking integrations. Built by Nitesh Kumar Singh (nkscoder).

Maintainer	Nitesh Kumar Singh — nkscoder.in
Package (PyPI)	nkscoder-indian-banks
Python import	indian_banks
Version	1.0.1
License	MIT
Python	3.10+

---

Why this project?

Finding reliable, verified Indian bank logos and metadata (IFSC prefix, USSD codes, official websites) is time-consuming for fintech and banking apps.

This repo is a single source of truth for:

• Official PNG / JPEG / AVIF bank logos (170+ files)
• Structured JSON metadata per bank
• Python API to look up banks by slug or IFSC prefix
• Ready for PyPI install in Django, Flask, FastAPI, or data pipelines

Keywords: Indian banks, bank logos India, IFSC bank code, RBI bank list, UPI fintech, balance check USSD, Nitesh Kumar Singh, nkscoder.

---

Install

From PyPI

pip install nkscoder-indian-banks

From source (development)

git clone https://github.com/nkscoder/indian-banks.git
cd indian-banks
pip install -e .

---

Quick start (Python)

import indian_banks

# List all banks
banks = indian_banks.get_all_banks()
print(len(banks), "banks loaded")

# Lookup by IFSC code or prefix
sbi = indian_banks.get_bank_by_ifsc("SBIN0001234")
print(sbi.name, sbi.website, sbi.ussd)

# Lookup by slug
hdfc = indian_banks.get_bank("hdfc")

# Resolve logo path on disk
logo_path = indian_banks.get_logo_path(sbi)
print(logo_path)  # .../indian_banks/logos/State Bank of India.png

---

Data schema

Each bank entry in indian_banks/data/banks.json includes:

Field	Example	Description
name	State Bank of India	Display name
slug	sbin	Unique short id
ifsc_prefix	SBIN	First 4 chars of IFSC
logo	State Bank of India.png	Logo filename
bank_type	public_sector	RBI category
website	https://sbi.co.in	Official site
ussd	*999#	Balance enquiry code

Full schema: docs/DATA.md

---

Bank slugs & logos (sample)

Bank Name	Slug	IFSC	Logo
State Bank of India	sbin	SBIN
HDFC Bank	hdfc	HDFC
ICICI Bank	icic	ICIC
Punjab National Bank	punb	PUNB
Union Bank of India	ubin	UBIN

➡️ 170+ banks with logos in indian_banks/logos/. Metadata enrichment is ongoing — contributions welcome.

---

Project layout

indian-banks/
├── indian_banks/           # Python package
│   ├── __init__.py
│   ├── banks.py            # lookup API
│   ├── data/banks.json     # structured metadata
│   └── logos/              # bank logo files
├── docs/DATA.md            # schema documentation
├── pyproject.toml
├── PUBLISHING.md           # PyPI upload guide
├── LICENSE
└── README.md

---

Publish to PyPI

To upload this package to PyPI:

1. Create an API token at pypi.org/manage/account/token
2. Build and upload — full steps in PUBLISHING.md

pip install build twine
python -m build
twine upload dist/*
# Username: __token__
# Password: <your-pypi-api-token>

GitHub Actions workflow (.github/workflows/publish-pypi.yml) publishes automatically on release when PYPI_API_TOKEN is set.

---

Roadmap

• Bank logo collection (170+ files)
• JSON metadata + Python API
• PyPI package (nkscoder-indian-banks)
• Vector (SVG) logos for all major banks
• Complete IFSC / USSD / website for every RBI-listed bank
• Automated verification against official RBI sources

Bank types reference: RBI Official List

---

Contributing

1. Fork the repo
2. Add or update a logo in indian_banks/logos/
3. Update indian_banks/data/banks.json (see docs/DATA.md)
4. Open a pull request

---

About Nitesh Kumar Singh (nkscoder)

Nitesh Kumar Singh develops open-source data packages and Django tools under nkscoder. indian-banks (nkscoder-indian-banks on PyPI) is a free, MIT-licensed dataset of Indian bank logos, IFSC prefixes, USSD codes, and RBI metadata for fintech apps and developers.

• Website: nkscoder.in
• GitHub: @nkscoder
• PyPI: nkscoder-indian-banks

For support, custom integrations, or fintech consulting, visit https://nkscoder.in.

---

License

Copyright © 2026 Nitesh Kumar Singh (nkscoder).

Released under the MIT License. Logos remain property of their respective banks; use only for identification and reference in applications.