Metadata-Version: 2.4
Name: crunch-model-runner
Version: 0.4.1
Summary: 
Author: boutrig abdennour
Author-email: abdennour.boutrig@crunchdao.com
Requires-Python: >=3.11,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: click (>=8.1.8,<9.0.0)
Requires-Dist: grpcio (>=1,<2)
Requires-Dist: grpcio-health-checking (>=1,<2)
Requires-Dist: importlib (>=1.0.4,<2.0.0)
Requires-Dist: joblib (==1.3.2)
Requires-Dist: pandas (>=2.2.3,<3.0.0)
Requires-Dist: protobuf (>=5.29.2,<6.0.0)
Requires-Dist: pyarrow (>=18.1.0,<19.0.0)
Requires-Dist: pytest (>=8.3.4,<9.0.0)
Requires-Dist: river (>=0.22.0,<0.23.0)
Description-Content-Type: text/markdown

# Model Runner

Runner used to run real-time models for the CrunchDAO competitions.

# Installation

> [!NOTE]
> **Python 3.11** or later is required.

```
pip install crunch-model-runner
```

# Usage

Once installed, you can run the runner using:

```bash
model-runner --code-directory tests/models_examples/bill
```

> [!NOTE]
> Replace `--code-directory` with the path to the directory containing the code.

## Options

| Declaration                   | Description                                                                                                        |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `--code-directory <path>`     | The directory path is where the code is located. This directory **must** exist.                                    |
| `--resource-directory <path>` | The directory path to where the resources are located. The directory will be created if it does not exist.         |
| `--main-file <name>`          | The file to use as the entry point to the model. It must be exists in the code directory.                          |
| `--log-level <level>`         | The logging level, must be one of: `"debug"`, `"info"`, `"warning"`, `"error"`, `"critical"`, default to `"info"`. |

# Contribute

Instructions on how to prepare your development environment are available at [CONTRIBUTE.md](./CONTRIBUTE.md).

