Metadata-Version: 2.4
Name: tree-praxis
Version: 0.0.14
Summary: Rashomon set tools via PRAXIS, including approximation, exact calculation, and variable importance utilities.
Author: Zakk Heile, Hayden McTavish, Varun Babbar, Margo Seltzer, Cynthia Rudin
License: MIT
Project-URL: Homepage, https://github.com/zakk-h/LicketyRESPLIT
Project-URL: Repository, https://github.com/zakk-h/LicketyRESPLIT
Project-URL: Issues, https://github.com/zakk-h/LicketyRESPLIT/issues
Keywords: interpretable machine learning,decision trees,rashomon set,optimization,variable importance
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: C++
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.23
Requires-Dist: matplotlib>=3.6
Requires-Dist: scikit-learn>=1.1
Requires-Dist: pandas>=1.5
Dynamic: license-file

# PRAXIS: Fast computation of near-optimal trees and the Rashomon set

PRAXIS is a high-performance C++/Python library for decision tree optimization. It includes (i) single decision tree optimization (both heuristic and optimal), (ii) Rashomon set computation (both approximate and optimal), and (iii)  variable importance computation over all good models via the Rashomon Importance Distribution (both approximate and exact). 

## Installation

### Building from Source

If you have access to C++ build tools, you can install directly from GitHub:

```bash
pip install "git+https://github.com/zakk-h/LicketyRESPLIT.git@praxis"
```

### Prebuilt Binary Wheels

To make installation simpler, LicketyRESPLIT provides prebuilt binary wheels for all major platforms:

- **Windows** (64-bit)
- **macOS** (Intel and Apple Silicon)
- **Linux** (any distribution)

**Supported Python versions:** 3.9 – 3.13

#### Installation Steps

1. Go to the release page: https://github.com/zakk-h/LicketyRESPLIT/releases/tag/praxis-v0.0.8

2. Choose the wheel that matches:
   - Your Python version (cp39, cp310, cp311, cp312, cp313)
   - Your operating system

3. Install it with pip (replace the URL with your chosen wheel file from step 2):

**macOS (Apple Silicon), Python 3.11:**
```bash
pip install "https://github.com/zakk-h/LicketyRESPLIT/releases/download/praxis-v0.0.8/praxis-0.0.8-cp311-cp311-macosx_11_0_arm64.whl"
```

## Example

See [`examples/example.ipynb`](examples/example.ipynb) for a complete walkthrough of using PRAXIS.
