Bank Statement Converter 📄

This is a simple bank statement converter that converts Nigerian bank statements from PDF to a structured format. It uses Python and Jupyter Notebook to extract data from the PDF file and convert it to CSV format.

💻 Tech Stack

Language - Python
Notebook - Jupyter
PDF Extraction - Camelot
Data Cleaning - Panda

👨🏻‍💻 Running Locally

You can start using this project locally by running the following command in your desired directory:

# uv
uv sync

Then add the bank statement pdf file you want to convert to the docs directory in the project's root directory. After that, you should reference the file in the Jupyter Notebook file <bank>-extract.ipynb and run it to convert the PDF file to CSV format.

📂 Bank Status

Bank Name	Status
Access Bank	✅
First Bank	✅
Opay	✅
GT Bank	❌
Zenith Bank	✅
Union Bank	❌
UBA	❌
Wema Bank	❌
Fidelity Bank	❌
Stanbic IBTC	❌
Ecobank	❌
Standard Chartered Bank	✅
Sterling Bank	❌
Providus Bank	❌
Moniepoint	❌
Kuda Bank	⚠️
Providus Bank	✅

📥 Contributing

Contributions are welcome! If you want to contribute to this project, please note the following:

• do not add any sensitive information to the codebase e.g. the bank statement pdf file.
• The content of the docs folder are ignored by git, so you can add your bank statement pdf files there.
• If you want to add a new bank, please create a new Jupyter Notebook file with the name <bank>-extract.ipynb and add it to the notebooks folder.
• Make sure to clear your notebook output before committing your changes to prevent sensitive information from being committed.

✨ Feedback & Suggestions

If you have any suggestions/feedback, you can contact me by email. Alternatively, feel free to open an issue if you find bugs or want to request new features.

📜 License

Licensed under the MIT License, Copyright © 2025

---

Made with 🤍 by Tosin Shada 👨🏻‍💻 and contributors.