stratosphere 0.1.23

A lightweight experimentation toolkit for data scientists.

Stratosphere

A lightweight experimentation toolkit for data scientists.

Designed for simplicity, efficiency and robustness. stratosphere lets you:

1. Define programmatically your experiments
2. Execute them in parallel with different backends
3. Track their real-time metrics and final results
4. Store them as serialized objects and tabular data in your database(s)
5. Query them with the best-suited interface: SQL, Pandas and Python

Built on top of solid components: SQLAlchemy, SQLite, Pandas, Joblib and Dask.

Installation

It officially requires Python >= 3.8.0, but it can be forced to work smoothly also on Python 3.7.13-15 (supporting Colab, Binder).

On Python >= 3.8.0:

• With PyPI: pip install "stratosphere[complete]" --upgrade # Install everything
• With Poetry: poetry add stratosphere@latest --extras complete # Install everything

On Python 3.7.13-15 with Google Colab or Binder, execute the following at the beginning of the notebook:

# Install dependencies
!pip install pandas joblib sqlalchemy sqlalchemy-utils ulid-py cloudpickle colorama tqdm --upgrade

# Install [complete] extras, required to run the tutorial
!pip install tabulate scikit-learn dask[complete] --upgrade

# Install the latest stratosphere version, ignoring the python version and dependencies
!pip install stratosphere --upgrade --ignore-requires-python --no-dependencies

You can also install only the stratosphere library (dropping the [complete] extras). Modules like stratosphere.utils.dask, stratosphere.utils.metrics, and stratosphere.utils.widgets won't work until you also install dask[complete], scikit-learn, and ipywidgets, respectively. These extras are required to run the tutorial notebooks.

Documentation

Follow the tutorial notebooks to learn the basic concepts. You can run the notebooks locally, on Colab and on Binder.

Project pages

• PyPI
• Github

License

This project is licensed under the terms of the BSD 3-Clause License.

Development

See the development page.

Contributing

Work in progress!