# SPML2-mltools

[![Python package](https://github.com/SermetPekin/spml2/actions/workflows/package.yml/badge.svg)](https://github.com/SermetPekin/spml2/actions/workflows/package.yml)
[![PyPI - Full Versions](https://github.com/SermetPekin/spml2/actions/workflows/pypi-full.yml/badge.svg)](https://github.com/SermetPekin/spml2/actions/workflows/pypi-full.yml)
[![PyPI](https://img.shields.io/pypi/v/spml2_mltools)](https://pypi.org/project/spml2-mltools/)
![Status](https://img.shields.io/badge/status-maintained-yellow.svg)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)

## Overview

**SPML2-mltools** is a convenient package for applying machine learning workflows with a Streamlit app, generating Excel outputs, and visualizations.

---

## Installation

```bash
pip install spml2-mltools
```

---

## Quick Start

### 1. Initialize Example Files

```bash
spml2 init
# Creates:
# - spml2_main.py
# - options_user.py
# - models_user.py
```

### 2. Run Classification

```bash
python spml2_main.py
```

### 3. Launch the Web UI

```bash
spml2 web
```

You can also use:
```bash
spml web
```
if installed with the alternate entry point.

---

## Features

- Streamlit-based web runner
- ROC curve visualization
- Feature importances
- SHAP graphs
- Excel output generation

---

## Documentation

- [Homepage](https://github.com/SermetPekin/spml2)
- [Documentation](https://github.com/SermetPekin/spml2)
- [Issues](https://github.com/SermetPekin/spml2/issues)
- [Changelog](https://github.com/SermetPekin/spml2/releases)

---
