Metadata-Version: 2.1
Name: openbk
Version: 1.0.0
Summary: A python library to easily extract information and metrics from Moroccan bank statements.
Home-page: https://github.com/imadarchid/openbk
Author: Imad Archid
Author-email: hello@imadarchid.com
License: GPL
Platform: UNKNOWN
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: COPYING

# openbk
[![Documentation Status](https://readthedocs.org/projects/openbk/badge/?version=latest)](https://openbk.readthedocs.io/en/latest/?badge=latest) ![PyPI - Downloads](https://img.shields.io/pypi/dw/openbk)

openbk is a small python library that can be used to read and extract transaction information from Moroccan bank statements (PDF).

[Installation](#dependencies-and-installation) | [Docs](https://openbk.readthedocs.io) | [Motivation](#motivation)

## Features

- Import an e-banking PDF statement and retrieve a clean DataFrame with transactions.
- Get basic metrics (total debit, total credit, net movements).
- Analyze bank transactions to extract their categories.
- Analyze card payments (online and offline) to detect merchants.
- Automatically detect which bank corresponds to the uploaded statement.

## Supported Banks
- ✅ CIH Bank (E-banking statements - Particuliers)
- ✅ Attijariwafa Bank (E-banking statements - Particuliers)
- 🔜 Banque Centrale Populaire (Coming Soon)

_Other banks will be decided in the future_

ℹ️ **Transaction categories**: I do not have a comprehensive list of transaction types, so I hope that the classification gets better with your contribution!

## Dependencies and Installation
openbk relies on [`tabula-py`](https://pypi.org/project/tabula-py/) to read and extract tables from PDFs. Tabula requires the following to function properly:
- Python 3.10+
- Java 8+

To add openbk to your project:
```sh
pip install openbk
```

Learn more about how to use `openbk` on our [docs](https://openbk.readthedocs.io).

## Motivation
This project aims to simplify the task for developers who want to build apps that rely on the analysis of bank statements (Wallets, Lending, Consumer Behavior analysis, etc.). Ideally, openbk can help developers and data analysts in their financial scoring processes for applications in the Moroccan context.

### Data Privacy
Please be careful when handling sensitive financial information and make sure to comply with the latest Moroccan data privacy laws and guidelines.


