Metadata-Version: 2.4
Name: AutoWoE
Version: 1.4.0
Summary: Library for automatic interpretable model building (Whitebox AutoML)
License-File: LICENSE
Author: Vakhrushev Anton
Author-email: btbpanda@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.15
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Typing :: Typed
Provides-Extra: s3
Requires-Dist: StrEnum (>=0.4.7,<0.5.0)
Requires-Dist: certifi (>=2023.7.22)
Requires-Dist: jinja2
Requires-Dist: joblib (>=1.2.0)
Requires-Dist: lightgbm (>=4.6.0)
Requires-Dist: matplotlib
Requires-Dist: numpy
Requires-Dist: packaging (>=20.0)
Requires-Dist: pandas
Requires-Dist: pillow (>=12.3.0)
Requires-Dist: pytz
Requires-Dist: requests (>=2.33.0)
Requires-Dist: s3fs ; extra == "s3"
Requires-Dist: scikit-learn (>=1.0.1)
Requires-Dist: scipy
Requires-Dist: seaborn (>=0.13.2)
Requires-Dist: tqdm (>=4.62.3,<5.0.0)
Requires-Dist: urllib3 (>=2.8.0)
Project-URL: Homepage, https://github.com/AILab-MLTools/AutoMLWhitebox
Project-URL: Repository, https://github.com/AILab-MLTools/AutoMLWhitebox
Description-Content-Type: text/markdown

## AutoWoE library
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/AutoWoE)](https://pypi.org/project/AutoWoE)
[![PyPI - Version](https://img.shields.io/pypi/v/AutoWoE)](https://pypi.org/project/AutoWoE)
![pypi - Downloads](https://img.shields.io/pypi/dm/AutoWoE?color=green&label=PyPI%20downloads&logo=pypi&logoColor=green)
[![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/sb-ai-lab/AutoMLWhitebox/CI.yml)](https://github.com/sb-ai-lab/AutoMLWhitebox/actions/workflows/CI.yml?query=branch%3Amaster)

### [Telegram chat](https://t.me/joinchat/sp8P7sdAqaU0YmRi) | [Telegram channel](https://t.me/lightautoml)

This is the repository for **AutoWoE** library, developed by LightAutoML group. This library can be used for automatic creation of interpretable ML model based on feature binning, WoE features transformation, feature selection and Logistic Regression.

**Authors:** Vakhrushev Anton, Grigorii Penkin, Alexander Kirilin

**Library setup** can be done by one of three scenarios below:

1. Installation from PyPI:
```bash
pip install autowoe
```
For the optional S3 client, install with `pip install 'autowoe[s3]'` instead.

2. Installation from source code

First of all you need to install [git](https://git-scm.com/downloads) and [poetry](https://python-poetry.org/docs/#installation).

```bash

# Load WhiteBox source code
git clone https://github.com/AILab-MLTools/AutoMLWhitebox.git

cd AutoMLWhitebox/

# !!!Choose only one item!!!

# 1. Recommended: Create virtual environment inside your project directory
poetry config virtualenvs.in-project true

# 2. Global installation: Don't create virtual environment
poetry config virtualenvs.create false --local

# For more information read poetry docs

# Install WhiteBox
poetry install

```


**Usage tutorials** are Jupyter notebooks in the `examples/` directory. Run them from that directory so their `./data/` paths resolve. For **parameters description** take a look at `parameters_info.md`.

**Bugs / Questions / Suggestions:**
- Seek prompt advice in [Telegram group](https://t.me/joinchat/sp8P7sdAqaU0YmRi).
- Open bug reports and feature requests on GitHub [issues](https://github.com/sb-ai-lab/AutoMLWhitebox/issues).
- Also follow our [Telegram channel](https://t.me/lightautoml)

